Valider l'intégration

Valide la configuration disponible et enregistre le diagnostic.

POST/integrations/{provider}/testintegrations:write

COMPORTEMENT

La requête valide l'entrée, conserve la commande et renvoie l'état initial. L'exécution peut se poursuivre dans la file d'attente dédiée.

EFFET

Vous pouvez créer des événements de travail asynchrone et de webhook après confirmation dans la base de données.

RÉPÉTITION

En cas de panne du réseau, confirmez l'état de la ressource avant de réessayer. Refaites automatiquement uniquement 429 et 5xx avec recul et gigue.

Demande

providerstring · pathIdentifiant du connecteur.obligatoire

AuthorizationBearer ach_live_...

Acceptapplication/json

Portéeintegrations:write

Exemple d'exécutable

curl

curl -X POST 'https://achadu.com/api/v1/integrations/string/test' \
  -H 'Authorization: Bearer ach_live_...' \
  -H 'Accept: application/json'

Réponse et erreurs

Chaque réponse inclut request_id. Les listes ajoutent une pagination ; les ressources mutables renvoient l'état persistant après l'opération.

200 application/json

{
  "data": {
    "provider": "amazon",
    "valid": true,
    "remote": true,
    "message": "Credential validated at the provider",
    "checked_at": "2026-08-31T18:20:00.000Z"
  },
  "request_id": "req_01J..."
}

200Opération terminée.

400Paramètre, corps ou transition non valide.

401Clé manquante, invalide, expirée ou révoquée.

402Le plan de compte ne libère pas cette interface.

403A chave precisa do escopo integrations:write.

404La fonctionnalité n'existe pas dans ce compte.

409L'état actuel empêche cette opération.

413Le corps JSON dépasse 128 Ko.

429La fenêtre de 120 requêtes par minute a été dépassée.

Valider l'intégration

Demande

Exemple d'exécutable

Réponse et erreurs

Opérations associées