SDK И API
SDK и API.
Запросы, токены и контракты. Десять практических инструкций.
Первый запрос к APIНачните с безопасного GET и укажите явную версию API в URL.
Авторизация по токенуЗагрузите токен из переменной окружения и используйте отдельный токен на каждую среду.
Пагинация по курсоруПродолжайте запросы с next_cursor из предыдущего ответа. Сохраняйте курсор после успешной обработки страницы.
Таймауты запросовОграничьте отдельно установку соединения и суммарное время запроса. Уложите повторы в общий бюджет операции.
Условный GET с ETagСохраните ETag вместе с телом ответа. При следующем запросе отправьте сохранённый ETag.
Идемпотентный POSTИспользуйте один ключ для всех повторов одной операции, если API поддерживает этот заголовок.
Обработка лимитов APIПри ответе 429 прочитайте Retry-After. Поддержите число секунд и HTTP-дату, если API использует оба формата.
Валидация JSON-ответаЗафиксируйте ожидаемые типы полей. Разбирайте ошибку API отдельно от успешной модели.
Выгрузка большого ответаПишите ответ в файл и обрабатывайте NDJSON построчно. Храните частичную выгрузку во временном файле.
Подпись вебхукаВычисляйте HMAC по исходным байтам тела до разбора JSON. Формат подписи сверяйте со спецификацией отправителя.