Przejdź do treści
AchaduDevelopers
Developers/API/commissions_sync
Prowizje

Synchronizuj prowizje

Odpytuj tylko autoryzowane złącza i rejestruj jedno potwierdzenie na źródło.

POST/commissions/synccommissions:write
ZACHOWANIE

Żądanie sprawdza poprawność danych wejściowych, utrwala polecenie i zwraca stan początkowy. Wykonywanie może być kontynuowane w dedykowanej kolejce.

EFEKT

Możesz tworzyć asynchroniczne zdarzenia robocze i webhook po potwierdzeniu w bazie danych.

POWTÓRKA

W przypadku awarii sieci potwierdź stan zasobu przed ponowną próbą. Automatycznie ponawiaj tylko 429 i 5xx z cofaniem i jitterem.

Żądanie

sourcesarray · bodyŹródła, z których warto korzystać.opcjonalne
fromstring · bodyStrona główna ISO 8601.date-timeopcjonalne
tostring · bodyKoniec z ISO 8601.date-timeopcjonalne
AuthorizationBearer ach_live_...
Acceptapplication/json
Zakrescommissions:write

Przykład wykonywalny

curl
curl -X POST 'https://achadu.com/api/v1/commissions/sync' \
  -H 'Authorization: Bearer ach_live_...' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  --data '{
  "sources": [],
  "from": "2026-09-01T15:00:00Z",
  "to": "2026-09-01T15:00:00Z"
}'

Odpowiedź i błędy

Każda odpowiedź zawiera request_id. Listy dodają paginację; zasoby modyfikowalne zwracają utrwalony stan po operacji.

200 application/json
{
  "data": {
    "id": "com_01J...",
    "marketplace": "amazon",
    "amount": 24.73,
    "currency": "BRL",
    "status": "approved",
    "order_id": "ORDER-123",
    "occurred_at": "2026-08-31T18:20:00.000Z"
  },
  "request_id": "req_01J..."
}
200Operacja zakończona.
400Nieprawidłowy parametr, treść lub przejście.
401Brakujący, nieprawidłowy, wygasły lub unieważniony klucz.
402Plan konta nie udostępnia tego interfejsu.
403A chave precisa do escopo commissions:write.
404Funkcja nie istnieje na tym koncie.
409Obecny stan uniemożliwia tę operację.
413Treść JSON przekracza 128 KB.
429Przekroczono okno 120 żądań na minutę.