Переключение между группами при сбое

Группа маршрутизации представляет собой набор каналов поставщика услуг. Обычный ключ API называет одну основную группу и, дополнительно, резервные группы в порядке приоритета. Когда основная группа не может обслужить запрос, шлюз продолжает работу по этому списку вместо того, чтобы возвращать клиенту ошибку.

Настройте цепочку в API Keys при создании или редактировании ключа. Порядок имеет значение, и консоль позволяет перемещать записи вверх и вниз.

Основная группа

Группа, указанная в ключе.

Приоритеты каналов внутри него

Каждый приоритет в группе проверяется перед следующей группой.

Следующая резервная группа

Изменение маршрута, а не повторная попытка того же поставщика услуг.

Счет выставляется обслуживавшей группой

Разрешенная группа записывается в журнал потребления.

Аварийное переключение охватывает только проблемы с маршрутом и соединением; ошибка клиента немедленно останавливает запрос.

Когда запрос переходит в следующую группу

• В группе нет канала для запрошенной модели.
• Группа достигла предела скорости для вашего аккаунта.
• Каждый приоритет канала внутри группы был опробован, но все равно возвратил ошибку, допускающую повторную попытку.

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

Когда это не так

Аварийное переключение охватывает только проблемы маршрута и соединения. Запрос немедленно прекращается:

• ошибки клиента — неверный формат JSON, неверный параметр, превышена длина контекста;
• отмененное клиентское соединение;
• запрос, закрепленный за одним конкретным каналом;
• потоковый ответ, который уже отправил вашему клиенту реальные байты тела. Сами по себе сердцебиения не закрывают дверь, но как только контент записан, запрос никогда не воспроизводится по другому маршруту.

Биллинг

После переключения запрос оплачивается с использованием множителя группы, которая его обслуживала, а не основной группы. Обслуживаемая группа записывается в журнал потребления.

Для групп кампаний требуется резервный вариант

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

Смарт-ключи API

Smart API Key уже проходит каждую группу, которую может использовать ваша учетная запись, упорядоченную по ее стратегии маршрутизации, поэтому он не создает резервный список вручную.