Passer au contenu
AchaduDevelopers
API opérationnelleAller sur le site Web
Tableau de bord
Developers/API/commission_import
Commissions

Commissions d'importation en CSV

Normalise un CSV, déduplique les transactions et produit un reçu vérifiable.

POST/commissions/importscommissions: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

marketplacestring · bodyMarketplace ou réseau par défaut.facultatif
filenamestring · bodyNom du fichier d'origine.maxLength 240facultatif
contentstring · bodyContenu UTF-8 du CSV.minLength 2 · maxLength 120000obligatoire
AuthorizationBearer ach_live_...
Acceptapplication/json
Portéecommissions:write

Exemple d'exécutable

curl
curl -X POST 'https://achadu.com/api/v1/commissions/imports' \
  -H 'Authorization: Bearer ach_live_...' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  --data '{
  "content": "I found a deal for you.",
  "marketplace": "string",
  "filename": "string"
}'

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.

201 application/json
{
  "data": {
    "id": "imp_01J...",
    "status": "processing",
    "source": "amazon",
    "rows_read": 0,
    "new_items": 0,
    "duplicates": 0,
    "errors": 0
  },
  "created": true,
  "request_id": "req_01J..."
}
201Ressource créée et conservé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 commissions: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.