Машинные данные

Ключ по почте

Ключ поднимает предел частоты обращений к машинным адресам портала — с 60 до 300 обращений в минуту; окно неподвижное, длиной 60 секунд. Больше он не делает ничего: все сведения портал отдаёт и без ключа, теми же адресами и в том же формате. Это представление, а не пропуск.

Получить ключ

Что портал об этом хранит

О ключе — пять вещей: отпечаток, дата выдачи, дата последнего использования, счёт обращений и дата отзыва. Времени суток нет ни у одной даты: строка о ключе — не журнал того, кто им работает.

Адрес почты не сохраняется ни строкой, ни отпечатком. Он живёт ровно столько, сколько нужно, чтобы отправить письмо. Хеш адреса — те же персональные данные: словарь настоящих адресов перебирается быстрее, чем четыре миллиарда диапазонов сетевых адресов, и отказ хранить одно, храня другое, был бы отказом на словах. Плата названа честно: связать два ключа одного адреса нечем, и отозвать прежний ключ при выдаче нового портал не может — это делает тот, у кого ключ.

Ключ ставится в заголовок X-Api-Key машинного обращения. В строке адреса ему не место: оттуда он попадает в журналы обратного прокси и в историю браузера.

Перестать пользоваться ключом

Отзыв — по самому ключу: ни адреса почты, ни учётной записи для этого не нужно. Он действует с того же запроса. Строка о ключе при этом остаётся с пометкой об отзыве: стереть её значило бы потерять и дату выдачи, и счёт обращений — то есть ровно то, чем отзыв потом объясняется.

Потерянный ключ не восстанавливается: показать его второй раз негде. Взамен выдаётся новый, а прежний отзывается здесь же.