Площадка полного цикла для API
Каталог, ключи, лимиты, счета, отладка и наблюдение — то, что каждый провайдер пишет заново и каждый раз наполовину. Мы написали это один раз и целиком, включая то, о чём обычно вспоминают на третий месяц: сверку до копейки, трассу вызова по стадиям и детектор ломающих изменений.
0 ppm
расхождение в сверке
На прогоне в миллион вызовов. Сверка считает период заново, независимым запросом, и сравнивает с книгой.
4 мс
накладные расходы шлюза, p99
Всё, что платформа добавляет к вашему времени ответа: ключ, квота, метрика.
739 мс
от «нашёл API» до рабочего кода
Машинное время всего пути: каталог, проба на моке, регистрация, ключ, настоящий вызов.
12 с
до сигнала об утечке ключа
От первого чужого вызова до придержания ключа и уведомления владельцу.
Ключ вместо десятка чужих способов авторизации, один домен вместо десятка. Публичный API можно попробовать вовсе без ключа: шлюз ответит примером из спецификации, и это честно помечено в заголовке ответа.
Ключ, тариф, квота, частота — и запись о вызове с его собственным идентификатором. Всё вместе стоит 4 мс на девяносто девятом перцентиле; это и есть цена того, что между вами кто-то стоит.
Счёт потребителю и выплата провайдеру, графики, трасса вызова по стадиям, наблюдение за доступностью, сигнал об утечке ключа. Ничего из этого не считается отдельно — источник один, поэтому две цифры не могут разойтись.
Публичный каталог — только один из каналов. API можно держать закрытым и выдавать доступ поимённо, можно открыть партнёрам, можно опубликовать для всех: видимость выбирает провайдер, и от неё зависит модель денег.
Целые копейки, двойная запись, неизменяемые проводки. Раз в сутки независимая сверка пересчитывает период заново — и если сойтись не удалось, счёт не выставляется, пока не разберёмся. Округление всегда в пользу того, кто платит.
0 ppm на миллионе вызовов
Аптайм, задержка, доля ошибок — из наших собственных проб и нашего же журнала. Скрыть их нельзя, накрутить нечем. Рядом честно написано, из скольких точек мы смотрим: пока из одной.
наблюдение из одной точки, и это написано
Спор «ваш API не работает» — «вы шлёте неверный запрос» кончается за полминуты: в трассе видно тело запроса, тело ответа и время по стадиям — ключ, квота, апстрим и наша собственная работа отдельной цифрой.
тело запроса, тело ответа, время по стадиям
Новая версия спецификации сравнивается со старой по смыслу. Пропало поле из ответа или появился обязательный параметр — выпуск под минорной версией не пройдёт, а подписчики получат отдельное предупреждение.
сравнение спецификаций по смыслу, а не по тексту
Всё в копейках целыми числами. Дробных денег в системе нет нигде: ни в базе, ни в расчёте, ни в отчётах. Округление — вниз, в пользу той стороны, что платит; у площадки нет способа заработать на округлении.
Расчёт помесячный. Абонплата берётся всегда, даже если вызовов не было: она за то, что площадка держит инфраструктуру, а не за объём. Если тариф менялся посреди месяца, каждый берёт свою долю по дням — и квота делится так же, иначе смена тарифа удваивала бы бесплатный объём.
Показатели в карточке API считаем мы, и провайдер на них не влияет — иначе они не значили бы ничего. Раздел «наши замеры» стоит отдельно от общей статистики: это то, что площадка проверила сама, своими пробами.
Заголовки и тела запросов записываются, только если провайдер включил захват. По умолчанию он выключен — это единственное место, где «выключено» и есть правильное значение по умолчанию: включённый захват означал бы, что площадка начала хранить данные клиентов провайдера, никого не спросив.
Список короткий и обновляется. Он здесь, потому что обещание, которого не выполняют, дороже отсутствующей функции.
Публичный API в каталоге отвечает на моке — без ключа и без регистрации. Понравится формат ответа — заведёте ключ и повторите тот же вызов на настоящем сервисе.