Paginacja, powtarzalność i rywalizacja bez niespodzianek.
Poniższe przekrojowe zasady mają zastosowanie do wszystkich zasobów i zapobiegają powielaniu, nieskończonym pętlom i delikatnym integracjom.
Ogranicz i przesuń paginację
Listy używają limitu od 1 do 100 i przesunięcia od zera. Kontynuuj, dopóki przesunięcie + długość.danych jest mniejsze niż paginacja.całkowita.
GET /api/v1/offers?status=approved&marketplace=amazon&limit=50&offset=100
{
"data": [ ... ],
"pagination": { "limit": 50, "offset": 100, "total": 384 },
"request_id": "req_01J..."
}Filtry i wyszukiwanie
statusFiltruje według stanu kanonicznego zasobu.queryWyszukiwanie tekstowe; traktuj to jako korespondencję, a nie identyfikator.marketplace / channelAkceptuje kod dostawcy udokumentowany w operacji.daysOkno analityki mobilnej od 1 do 365 dni.from / toJeśli są obecne, użyj znaczników czasu ISO 8601 w formacie UTC.Idempotencja i bezpieczne powtarzanie
GET, PATCH i DELETE można powtórzyć w tym samym znaczeniu. Kreacje posiadające udokumentowany klucz naturalny, np. oferta poprzez adres URL i otrzymywanie poprzez odniesienie zewnętrzne, zwracają istniejący zasób zamiast go duplikować.
Awarie sieci, błędy 429 i 5xx z wykładniczym backoffem i jitterem.
POST bez klucza naturalnego: zapytanie za pomocą zewnętrznego identyfikatora przed ponowną próbą.
400, 401, 402 i 403 aż do prawidłowego wpisu, klucza, planu lub zakresu.
Łączy Twoje wezwanie z audytem i upraszcza wszelkie dochodzenie.