Постапете со ограничувања и серверски грешки

Постапете со одговор 429

Барање што е ограничено по стапка враќа 429 Too Many Requests со detail.status поставено на rate_limit_exceeded. Пред повторување прочитајте ги заглавијата:

• Retry-After го дава минималното чекање во секунди за одбиено барање.
• X-RateLimit-Limit го покажува ограничувањето на групата.
• X-RateLimit-Remaining го покажува преостанатиот број барања.
• X-RateLimit-Reset покажува кога групата се ресетира.

Почекајте колку што наведува Retry-After, па повторете со експоненцијално одложување и случајно поместување. Намалете ги паралелните барања и ставете ја работата во ред, наместо да испратите налет веднаш по ресетирањето.

Постапете со серверски грешки

За одговор 500, јавното тело содржи општа грешка и request_id; внатрешните детали за исклучокот не се враќаат. 503 може да значи дека потребна услуга е привремено недостапна.

Повторувајте барања само за читање со ограничено одложување. Пред повторување барање за создавање, ажурирање, плаќање или друга промена на состојба, утврдете дали првиот обид завршил. Истекување на време или одговор 5xx не докажува дека промената не успеала, а веднаш повторено барање може да создаде дупликат.

Зачувајте дијагностика

Запишете ги времето, методот, патеката, статусот, телото на одговорот и X-Request-Id. Никогаш не запишувајте ја вредноста на x-api-key во дневник. Запрете ги автоматските повторувања по мал, ограничен број обиди и пријавете го неуспехот за преглед.