Notificaciones de estado
Su aplicación puede recibir notificaciones de estado de procesamiento en lugar de realizar sondeos repetidos. Mantenga el ID de renderizado y la búsqueda de estado como una forma de conciliar los resultados.
1. Prepare un receptor
Utilice un punto final HTTPS accesible públicamente, no un host local/red privada. Verificar firmas; un cuerpo de apariencia plausible no es prueba de origen.
2. Crea un punto final en la aplicación
Abra los Webhooks del proyecto, proporcione un nombre y una URL, luego guarde el secreto de firma de forma segura en su servidor. El secreto se revela en la creación; manténgalo fuera del código de interfaz y de las capturas de pantalla.
3. Enviar una prueba
Utilice Probar e inspeccionar el estado, los intentos y los errores de HTTP de entrega. Un evento webhook.test no es un PDF completo.
4. Manejar eventos de renderizado
Las notificaciones reales utilizan renders.status. Conserve la recepción de forma segura y responda con prontitud, luego realice un procesamiento más largo por separado. No reconozca antes de que su sistema pueda retener de manera confiable el evento.
Operar el punto final
Habilite/deshabilite deliberadamente y use el historial de entrega para el diagnóstico. Repare un punto final existente en lugar de crear duplicados. Lea la verificación de firma antes de procesar datos reales.