Ga naar de inhoud
AchaduDevelopers
Operationele APIGa naar website
Dashboard
Developers/API/commission_import
Commissies

Importcommissies in CSV

Normaliseert een CSV, ontdubbelt transacties en produceert een controleerbaar ontvangstbewijs.

POST/commissions/importscommissions:write
GEDRAG

Het verzoek valideert de invoer, zet de opdracht voort en retourneert de beginstatus. De uitvoering kan doorgaan in de speciale wachtrij.

EFFECT

U kunt na bevestiging in de database asynchrone werk- en webhookgebeurtenissen aanmaken.

HERHALING

Bij een netwerkfout bevestigt u de bronstatus voordat u het opnieuw probeert. Alleen 429 en 5xx automatisch opnieuw uitvoeren met backoff en jitter.

Verzoek

marketplacestring · bodyMarktplaats of standaardnetwerk.optioneel
filenamestring · bodyOriginele bestandsnaam.maxLength 240optioneel
contentstring · bodyUTF-8 inhoud van de CSV.minLength 2 · maxLength 120000verplicht
AuthorizationBearer ach_live_...
Acceptapplication/json
Reikwijdtecommissions:write

Uitvoerbaar voorbeeld

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"
}'

Reactie en fouten

Elk antwoord bevat request_id. Lijsten voegen paginering toe; veranderlijke bronnen retourneren de persistente status na de bewerking.

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..."
}
201Resource gemaakt en bewaard.
400Ongeldige parameter, hoofdtekst of overgang.
401Ontbrekende, ongeldige, verlopen of ingetrokken sleutel.
402Het accountplan geeft deze interface niet vrij.
403A chave precisa do escopo commissions:write.
404Functie bestaat niet in dit account.
409De huidige status verhindert deze bewerking.
413De JSON-hoofdtekst is groter dan 128 KB.
429Het venster van 120 verzoeken per minuut is overschreden.