Commissioni
Commissioni di importazione in CSV
Normalizza un CSV, deduplica le transazioni e produce una ricevuta verificabile.
POST
/commissions/importscommissions:writeCOMPORTAMENTO
La richiesta convalida l'input, rende persistente il comando e restituisce lo stato iniziale. L'esecuzione può continuare nella coda dedicata.
EFFETTO
È possibile creare eventi di lavoro asincrono e webhook dopo la conferma nel database.
RIPETIZIONE
In caso di errore di rete, verificare lo stato della risorsa prima di riprovare. Ripristina automaticamente solo 429 e 5xx con backoff e jitter.
Richiesta
marketplacestring · bodyMarketplace o rete predefinita.facoltativofilenamestring · bodyNome del file originale.maxLength 240facoltativocontentstring · bodyUTF-8 contenuto del CSV.minLength 2 · maxLength 120000obbligatorioAuthorization
Bearer ach_live_...Accept
application/jsonAmbito
commissions:writeEsempio eseguibile
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"
}'Risposta ed errori
Ogni risposta include request_id. Gli elenchi aggiungono l'impaginazione; le risorse mutabili restituiscono lo stato persistente dopo l'operazione.
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..."
}201Risorsa creata e persistente.400Parametro, corpo o transizione non validi.401Chiave mancante, non valida, scaduta o revocata.402Il piano dell'account non rilascia questa interfaccia.403A chave precisa do escopo commissions:write.404La funzionalità non esiste in questo account.409Lo stato attuale impedisce questa operazione.413Il corpo JSON supera i 128 KB.429La finestra di 120 richieste al minuto è stata superata.