Как устроен доступ
Доступ выдаётся проекту, а не человеку: у проекта есть владелец (аккаунт iBus), группы методов, ключи, при желании - IP-адреса, и лимиты.
1. Заявка
Войдите в iBus и опишите проект: что вы делаете, какие данные нужны, ожидаемая нагрузка, как и с каких адресов будете обращаться к API. E-mail аккаунта становится подтверждённым контактом.
Одновременно открыта одна заявка; черновик сохраняется, пока вы пишете.
2. Рассмотрение
Команда iBus читает каждую заявку и может задать вопрос. Ответить можно на странице заявки - там же виден статус: черновик, отправлена, на рассмотрении, нужны уточнения, одобрена или отклонена.
До одобрения ключа нет; срок рассмотрения не обещаем.
3. Проект и ключи
- После одобрения проект появляется в кабинете разработчика с его группами и лимитами.
- Ключ создаётся там же. Он показывается один раз; iBus хранит только хеш и короткий префикс, например
ibk_live_k_7mq2xw4hzt. - До 5 рабочих ключей на проект, отдельно
testиlive. При замене старый ключ работает ещё до 24 часов. - Утёкший ключ отзывается одним нажатием и перестаёт работать за секунды.
4. IP-адреса
Со списком адресов запрос должен прийти и с верным ключом, и с разрешённого адреса. Если ограничение включено, а список пуст, отклоняется всё. Частные и слишком широкие сети не принимаются; широкую сеть нужно подтвердить отдельно.
Если ограничение установила команда iBus, изменения проходят через запрос на странице проекта.
5. Лимиты
| Кто | В минуту (всплеск) | В сутки, UTC | В месяц, UTC | Одновременно | Тяжёлые: в минуту / в сутки |
|---|---|---|---|---|---|
| Проект, «пробный» | 30 (10) | 1 000 | 20 000 | 2 | — |
| Проект, «стандарт» | 120 (30) | 20 000 | 400 000 | 4 | — |
| Проект, индивидуально (пример) | 120 (30) | 20 000 | 400 000 | 4 | 6 / 300 |
| Без ключа: только старые адреса, на адрес (переходный режим) | 60 (30) | 20 000 | 400 000 | 6 | 20 / 600 |
Суточный и месячный бюджеты обновляются в 00:00 UTC (02:00 или 03:00 по Израилю, в зависимости от сезона). Отказ сообщает, какой лимит исчерпан и когда повторить (Retry-After). Индивидуальные лимиты iBus устанавливает по запросу.
6. Приостановка и блокировка
iBus может приостановить проект (ключи сохраняются) или заблокировать его (все ключи отзываются) - всегда с причиной на странице проекта, где можно ответить. Повторные нарушения, например много неверных ключей, ведут к короткой автоматической паузе; долгую блокировку решает только человек.
7. Что хранится
- О каждом запросе: время, проект, префикс ключа, метод, статус, длительность и сетевая часть адреса. Подробно - 7 дней, дальше только счётчики.
- Полные адреса запросов с параметрами и координаты из ваших запросов не сохраняются.
- Ключи не попадают в журналы, отчёты и сообщения.
Все коды отказов и что делать: ошибки доступа.