Реселлерам/Чек-лист интеграции

Чек-лист для реселлеров

Если вы перепродаёте Wokey API своим пользователям, пройдите по списку ниже по порядку. Каждый пункт ведёт к подробному описанию.

Чек-листlink

  1. 1

    Передавайте X-End-User-Id в каждом запросе

    Когда один ключ обслуживает много конечных пользователей, этот заголовок показывает, к какому пользователю относится запрос. Если один пользователь постоянно нарушает правила, Wokey ограничивает только его, остальные продолжают работать. Корпоративные аккаунты и реселлеры также могут смотреть ограниченных пользователей и снимать ограничения в консоли.

    ID и ограничения пользователей →

  2. 2

    Распознавайте отказы модели

    При отказе модели HTTP-статус всё равно 200, поэтому распознавайте его по полям ответа. Обнаружив отказ, попросите пользователя изменить запрос, а не повторяйте его как есть.

    Отказы модели →

  3. 3

    Останавливайте нарушителей заранее

    Повторные отказы приводят к ограничению частоты, приостановке модели и сборам за нарушения. С X-End-User-Id или без него нарушения засчитываются вашему аккаунту, поэтому фильтруйте контент до отправки запросов в Wokey.

    Сборы и ограничения за нарушения →

  4. 4

    Обрабатывайте ошибки по статус-коду

    Различайте нехватку баланса (402), ограничение частоты (429) и ошибки апстрима (502, 504, 529): сообщайте пользователю или повторяйте запрос. Обращаясь в поддержку, указывайте заголовок ответа x-wokey-request-id.

    Коды ошибок →

  5. 5

    Следите за балансом и расходом

    Баланс аккаунта — /v1/dashboard/balance, расход и остаток лимита по ключу — /v1/usage и /v1/key. Пополняйте баланс заранее.

    Баланс и расход →

  6. 6

    При необходимости выбирайте поставщика

    Если у модели несколько поставщиков, укажите provider в теле запроса, чтобы выбрать или исключить поставщиков.

    Выбор поставщика →