Paginering, herhaling en competitie zonder verrassingen.
De onderstaande transversale regels zijn van toepassing op alle bronnen en voorkomen duplicatie, oneindige lussen en kwetsbare integraties.
Paginering beperken en verschuiven
Lijsten gebruiken een limiet van 1 tot 100 en een offset van nul. Ga door zolang offset + data.length kleiner is dan paginering.total.
GET /api/v1/offers?status=approved&marketplace=amazon&limit=50&offset=100
{
"data": [ ... ],
"pagination": { "limit": 50, "offset": 100, "total": 384 },
"request_id": "req_01J..."
}Filteren en zoeken
statusFiltert op de canonieke status van de bron.queryTekstueel zoeken; behandel het als correspondentie, niet als een identificatiemiddel.marketplace / channelAccepteert de providercode die in de bewerking is gedocumenteerd.daysMobiele analyseperiode tussen 1 en 365 dagen.from / toGebruik, indien aanwezig, ISO 8601-tijdstempels in UTC.Idempotentie en veilige herhaling
GET, PATCH en DELETE kunnen met dezelfde betekenis worden herhaald. Creaties die een gedocumenteerde natuurlijke sleutel hebben, zoals aanbieden via URL en ontvangen via externe referentie, retourneren de bestaande bron in plaats van deze te dupliceren.
Netwerkstoringen, 429- en 5xx-fouten met exponentiële back-off en jitter.
POST zonder natuurlijke sleutel: query op externe identificatie voordat u het opnieuw probeert.
400, 401, 402 en 403 tot juiste invoer, sleutel, plan of scope.
Het koppelt uw oproep aan de audit en vereenvoudigt elk onderzoek.