Ограничения на честотата и сървърни грешки

Обработете отговор 429

Заявка, достигнала лимита на честотата, получава 429 Too Many Requests със стойност rate_limit_exceeded в detail.status. Прочетете заглавките на отговора преди повторен опит:

• Retry-After дава минималното изчакване в секунди за отхвърлена заявка.
• X-RateLimit-Limit показва лимита на групата заявки.
• X-RateLimit-Remaining показва оставащите заявки.
• X-RateLimit-Reset показва кога лимитът на групата се нулира.

Изчакайте времето от Retry-After, след което повтаряйте с експоненциално нарастваща пауза и малко случайно отклонение. Намалете паралелните заявки и поставяйте работата на опашка, вместо да изпращате пакет веднага след нулиране на прозореца.

Обработете сървърните грешки

При отговор 500 публичното тяло съдържа обща грешка и request_id; вътрешните подробности за изключението не се връщат. 503 може да означава, че необходима услуга временно не е достъпна.

Повтаряйте заявки само за четене с ограничено изчакване. Преди да повторите заявка за създаване, актуализация, плащане или друга промяна на състоянието, установете дали първият опит е завършил. Изтекло време или отговор 5xx не доказва, че промяната не е направена, а незабавното повторение може да дублира работата.

Запазете диагностичните данни

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