Pay : webhooks

Renvoyer un événement Pay

POST/v1/events/{id}/resend

Remet l’événement dans la file d’envoi pour les points actifs qui y sont abonnés (ou seulement endpoint_id). L’événement garde son X-Event-Id. Une livraison en cours n’est pas touchée.

Authentification: Clé d’API (Authorization: Bearer)
Portée requise: pay:write

Rejouable sans risque avec l’en-tête Idempotency-Key : voir Idempotence.

Paramètres de chemin#

idstringobligatoire
evt_ suivi de 32 chiffres hexadécimaux minuscules (même valeur que l’en-tête X-Event-Id des webhooks).

^evt_[0-9a-f]{32}$

En-têtes#

Idempotency-Keystringobligatoire
Obligatoire sur tous les POST Pay ; rend la requête rejouable sans risque pendant 24 heures. Cloisonné par environnement de la clé.

de 1 à 255 caractères

Corps de la requête#

endpoint_idstring · uuid

Réponses#

202Événement remis en file.

Champs de l’objet

objectstring
Valeurs event_resend
event_idstring
requeuedinteger

4xx · 5xxErreur.

Erreur au format standard : voir Erreurs.

Requête

cURL

curl -X POST "https://aicscan.io/v1/events/evt_7850b21f0ab248a5e16ddedf2c6626e9/resend" \
  -H "Authorization: Bearer $AICSCAN_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "endpoint_id": "0193a1c9-41aa-7b2e-9c0d-1e2f3a4b5c6d"
  }'

JavaScript

const res = await fetch('https://aicscan.io/v1/events/evt_7850b21f0ab248a5e16ddedf2c6626e9/resend', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.AICSCAN_API_KEY}`,
    'Content-Type': 'application/json',
    'Idempotency-Key': crypto.randomUUID(),
  },
  body: JSON.stringify({
    "endpoint_id": "0193a1c9-41aa-7b2e-9c0d-1e2f3a4b5c6d"
  }),
});
const data = await res.json();
if (!res.ok) throw new Error(data.error.code);
console.log(data);

Python

import os, uuid
import requests

resp = requests.post(
    "https://aicscan.io/v1/events/evt_7850b21f0ab248a5e16ddedf2c6626e9/resend",
    headers={
        "Authorization": f"Bearer {os.environ['AICSCAN_API_KEY']}",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={
        "endpoint_id": "0193a1c9-41aa-7b2e-9c0d-1e2f3a4b5c6d"
    },
    timeout=10,
)
resp.raise_for_status()
print(resp.json())

Réponse 202

JSON

{
  "object": "event_resend",
  "event_id": "string",
  "requeued": 0
}