API-ключи для разработчиков
Ключ API нужен, чтобы получать ответы SafeLaw в своём приложении. Рабочий ключ тратит деньги с кошелька аккаунта, отладочный — ничего не тратит.
Создать ключ
- Откройте «Настройки» → «API».
- В блоке «Новый ключ» введите «Название» и выберите «Режим»: «Рабочий» или «Отладочный».
- Нажмите «Создать».
- В окне «Ключ создан» нажмите «Скопировать» или «Скачать файлом» и сохраните ключ в надёжном месте.
- Нажмите «Готово, я сохранил». До обновления страницы ключ ещё доступен в полосе вверху: «Ключ ещё доступен для копирования — до обновления страницы.»
Режимы
| Режим | Начало ключа | Что тратит |
|---|---|---|
| Рабочий | sf_live_… | баланс кошелька: $2 за 1 млн входящих токенов, $4 за 1 млн исходящих, списание в сумах |
| Отладочный | sf_test_… | ничего — отвечает по упрощённой модели, для проверки интеграции |
Управлять ключами — в блоке «Мои ключи»:
- «Скопировать» — скопировать значение ключа;
- «Настройки» — название и «Месячный предел, токенов» («0 — без предела»). Предел защищает от скрипта, который за ночь израсходует весь баланс;
- «Перевыпустить» — новый ключ с тем же балансом и настройками; старый перестаёт работать сразу;
- «Отозвать» — запросы с ключом перестают работать сразу.
В блоке «Наблюдение» видны запросы, расход и ошибки за 7, 30 или 90 дней. Все рабочие ключи тратят общий баланс «Кошелёк». Чтобы пополнить кошелёк, напишите в поддержку.
Ключи организации создаёт только руководитель: «Организация» → «Настройки» → «API-ключи».
Если не работает
| Что видите | Что делать |
|---|---|
| «API пока недоступен для вашего аккаунта.» | Напишите в поддержку SafeLaw. |
| «Рабочий ключ расходует оплаченные токены. Новый ключ создаётся с нулевым балансом — сначала купите токены.» | Пополните кошелёк, затем пользуйтесь рабочим ключом. Для проверки возьмите отладочный. |
| «Значение этого ключа недоступно для показа — перевыпустите ключ, чтобы получить новое.» | Нажмите «Перевыпустить» и замените ключ в своём приложении. |
| «Ключи API может создавать только руководитель.» | Ключи организации создаёт руководитель. |
| «Ключ не найден или уже отозван.» | Создайте новый ключ. |
Связанные статьи
Статья помогла?
Спасибо! Рады, что помогло.
Жаль. Напишите нам в Telegram или на support@safelaw.ai — поможем и дополним статью.