Écritures et idempotence

Idempotency-KeyCopier le lien

Chaque POST exige un en-tête Idempotency-Key : 8 à 128 caractères A-Z a-z 0-9 _ . : -, un UUID par exemple.

• Rejouer la même clé avec la même requête rend la même réponse sans seconde écriture (en-tête Idempotent-Replayed: true), pendant 24 h.
• La même clé pour une autre requête répond 422.
• Les PUT et DELETE sont idempotents par nature.

La note de l'équipeCopier le lien

Écrire la note exige la révision lue (expectedRevision) : une écriture concurrente répond 409. Relisez la fiche du fan, puis réécrivez.

Mettre l'IA en pause sur un fan (MYM)Copier le lien

C'est le même geste que « Arrêter le chatting » dans le dashboard : le filtre de fans de la créatrice. Deux cas répondent 409 et se font depuis le dashboard, parce qu'ils dépassent ce fan :

• une créatrice qui répond à tous (le geste changerait son mode) ;
• le dernier fan d'une liste blanche (le retirer couperait toute la créatrice).

curl -X POST https://app.fanconvert.ai/public/v1/creators/emma-demo/conversations/123/ai/pause \
  -H "Authorization: Bearer $FANCONVERT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"

…/ai/resume rend le fan à l'IA (« Relancer le chatting »).