wyro

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, con details.reason: "in_progress": espera un segundo y reintenta.
  • Las respuestas que significan "reintenta" (429 y 5xx) 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 trae api_key, webhook_secret y mcp_url en null (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).