En este artículo
Un escenario de Make puede volver a ejecutar la misma solicitud, por ejemplo tras un tiempo de espera agotado. Por eso, para las acciones de escritura de FITsociety usas un valor identificador fijo para un único cambio de tu sistema de origen. En los módulos de FITsociety, este campo puede llamarse Source operation key.
Si la misma solicitud se repite con la misma clave y el mismo contenido, FITsociety puede reconocer el resultado anterior. Así reduces la probabilidad de que una repetición normal provoque un segundo cambio. Este reconocimiento tiene un periodo de conservación limitado y no sustituye la comprobación de tu escenario.
Elegir una buena clave
Usa preferentemente el ID de evento único de la app que inicia tu escenario. Añade una acción reconocible. Ejemplos con ID ficticios:
Crear un nuevo miembro del CRM:
crm:event-123:create-client.Añadir una etiqueta tras el envío de un formulario:
form:submission-456:add-tag.Actualizar un campo adicional tras un evento de FITsociety: el ID del evento seguido de
:update-goal-field.
Mapea este valor al campo de origen del módulo previsto para ello. Así se mantiene igual en una ejecución repetida. ¿Usas dos pasos para cambios distintos dentro de un mismo evento? Dale a cada uno su propio sufijo, por ejemplo :update-field-a y :update-field-b.
¿Cuándo reutilizas la clave?
Usa la misma clave y la misma entrada cuando vuelvas a intentar el mismo cambio tras un fallo. Usa una clave nueva para un evento o un cambio realmente nuevo.
No uses la hora actual, un ID aleatorio ni un ID de ejecución que cambie en cada intento. Tampoco uses un único valor fijo para todos los miembros. No pongas nombres ni direcciones de correo electrónico en la clave.
¿Qué haces con el código de error 409?
Un código de error 409 puede significar que una solicitud todavía se está procesando, que un registro ya existe o que se ha usado la misma clave con una entrada distinta.
Comprueba primero la ejecución anterior y el resultado en FITsociety. No cambies la clave solo para evitar el error; así podrías provocar igualmente un cambio duplicado. Al repetir, compara también el contenido de la solicitud con la entrada original.
El periodo de conservación y la identificación permanente de miembros
El reconocimiento de solicitudes de la Public API mediante una clave de idempotencia tiene un periodo de conservación de 24 horas. No es una deduplicación ilimitada de ejecuciones futuras. Para eventos que puedan volver a llegar más tarde, registra también en tu escenario o sistema de origen qué ID de evento se han procesado.
¿Tu módulo de creación ofrece un ID de origen permanente para el miembro? Usa ahí un ID de miembro permanente de tu sistema de origen. Guarda la relación con el ID de miembro de FITsociety y usa una acción de actualización para los cambios posteriores. Este reconocimiento está vinculado al acceso concedido a tu conexión.
¿Has revocado el acceso y después has vuelto a conectar? Busca primero los miembros existentes. No vuelvas a iniciar sin más los pasos de creación originales: un nuevo consentimiento también puede implicar un nuevo contexto de acceso.
¿Aún no tienes conexión? Lee Conectar FITsociety con Make.