Circle retirará la Versión 1 (V1) de webhooks. La Versión 2 (V2) es el modelo admitido a largo plazo y toda la funcionalidad de webhook se trasladará allí.
Qué significa esto para usted:
Si creó sus webhooks recientemente y ya están en V2, no se requiere ninguna acción.
Un webhook es una forma en que Circle notifica a su aplicación cuando ocurre un evento. En lugar de llamar repetidamente a una API de Circle para verificar actualizaciones, su aplicación registra un endpoint HTTPS. Circle envía una notificación de evento a ese endpoint cuando ocurre un evento compatible, como un cambio en el estado de una transacción.
Su aplicación debe autenticar o verificar las notificaciones entrantes, procesar los eventos de manera independiente para que los envíos duplicados no causen acciones duplicadas y devolver una respuesta HTTP exitosa después de aceptar un evento.
Circle tiene dos generaciones de tecnología de webhook:
Las dos versiones utilizan diferentes modelos de entrega, eventos, cargas útiles y verificación de firmas. Debido a estas diferencias, una suscripción V1 no se convierte automáticamente a V2. Las suscripciones V1 existentes continúan enviando eventos durante el período de migración admitido y migrar a V2 es una actualización técnica independiente que usted controla.
|
Capacidad |
V1 |
V2 |
|---|---|---|
|
Mantenido a largo plazo |
No; retiro programado |
Sí |
|
Reintentos automáticos con backoff |
No |
Sí |
|
Notificaciones firmadas que puede verificar |
No |
Sí |
|
Identificador de deduplicación incorporado |
No |
Sí |
|
Recibir eventos en una suscripción existente |
Sí, hasta que se retire V1 |
Sí |
Migrar una integración de V1 a V2 es un cambio técnico, no una configuración. V2 utiliza una estructura de eventos diferente, un modelo de nombres de eventos diferente y un método de verificación de firmas también diferente. Es posible que su integración requiera actualizaciones para:
Revise la documentación para desarrolladores de V2 correspondiente a los productos y tipos de eventos que utiliza antes de cambiar el tráfico de producción.
Para reducir el riesgo de eventos perdidos o duplicados:
Circle proporcionará un aviso previo antes de deshabilitar la creación de nuevas suscripciones V1 o retirar la entrega existente de V1.