Configurar webhooks

Un webhook es una forma de que VerifyPDF le diga a tu sistema que un resultado está listo, en vez de que tu sistema lo pregunte una y otra vez. Este artículo explica la idea y cómo activarlo.

Qué es un webhook, en pocas palabras

Cuando verificas un documento, el resultado no siempre está listo al instante. Sin un webhook, tu sistema tiene que comprobar constantemente “¿ya está?”. A eso se le llama sondeo.

Un webhook le da la vuelta a eso. Le das a VerifyPDF una URL de tu propio sistema. Cuando un resultado está listo, VerifyPDF llama a esa URL y te envía el resultado. Tu sistema reacciona a la llamada en vez de sondear los cambios.

Configura una URL de webhook por clave

Cada clave de API puede tener su propia URL de webhook. La configuras en el panel:

1. Inicia sesión en secure.verifypdf.com y abre Desarrolladores en la barra lateral izquierda.
2. Elige la clave de API que quieres usar y edita su URL de webhook haciendo clic en la flecha para desplegar la sección de configuración del webhook.
3. Guarda. La URL debe empezar por https://.

Como la URL se configura por clave, puedes dirigir las notificaciones de distintas integraciones a distintos puntos finales, por ejemplo una clave de prueba apuntando a una URL de prueba y una clave real a tu URL de producción. Consulta Claves de API de prueba y reales.

Para desactivar los webhooks de una clave, deja vacío el campo de URL y guarda.

Qué envía VerifyPDF

Cuando una verificación termina, VerifyPDF llama a tu URL de webhook para que tu sistema pueda actuar sobre el resultado, por ejemplo actualizar un caso o avisar a un revisor. Para el formato exacto y cómo comprobar que una llamada vino realmente de VerifyPDF, consulta la referencia de la API en /agents/ y la documentación de Desarrolladores dentro del panel.

Próximos pasos

• ¿Necesitas una clave primero? Consulta Generar y gestionar claves de API.
• ¿Quieres el flujo de envío completo? Consulta Verificar un documento con la API.