Idempotencia y duplicados
Los agentes reintentan: un timeout, una respuesta perdida, un paso que se vuelve a ejecutar. Dos herramientas evitan que un reintento publique dos veces.
Idempotency-Key
Envía Idempotency-Key: <valor único> (un UUID, o un id de tu sistema; hasta 255 caracteres) en POST /v1/posts, POST /v1/connect, POST /v1/media (JSON), POST /v1/partner/workspaces.
curl -X POST https://wyroapi.com/v1/posts \
-H "Authorization: Bearer $WYRO_API_KEY" \
-H "Idempotency-Key: 6f1c2a9e-3b7d-4c55-9e1a-0d2b8f4a7c11" \
-H "Content-Type: application/json" \
-d '{"text": "…", "platforms": ["instagram"], "media": [{"url": "https://…/a.jpg"}]}'
- La misma clave con el mismo body desde el mismo espacio de trabajo (o partner) dentro de 24 h devuelve la primera respuesta (mismo status y body) sin hacer el trabajo otra vez. Viene con el header
Idempotent-Replayed: true. - La misma clave con otro body responde
409 idempotency_conflict. Si la primera solicitud todavía se está procesando, también 409, condetails.reason: "in_progress": espera un segundo y reintenta. - Las respuestas que significan "reintenta" (
429y5xx) no se guardan: reintentar con la misma clave vuelve a ejecutar la solicitud. - Las credenciales nunca se guardan: en
POST /v1/partner/workspaces, la respuesta repetida traeapi_key,webhook_secretymcp_urlennull(rota la clave si la perdiste). - Guardamos solo hashes de la clave y de la solicitud, junto a la respuesta.
Freno a duplicados
POST /v1/posts rechaza el mismo texto en la misma cuenta dentro de 24 h con 409 duplicate_post y details.existing_post_id. El texto se compara ignorando espacios en los extremos y espacios repetidos (las mayúsculas cuentan). Los posts fallidos no cuentan, y los cancelados se borran. También aplica a los posts simulados, para que lo veas mientras pruebas.
Si la persona de verdad quiere publicarlo otra vez, envía "allow_duplicate": true en el body (en el MCP, permitir_duplicado: true).