Программное управление API Key
Чтение, создание, обновление и удаление API Key с токеном доступа.
Руководство по автоматизации управления ключами в приложении. Если нужны только вызовы моделей или SDK, см. API Key и авторизация.
Получить токен доступа
Создайте токен доступа в разделе «Безопасность» страницы профиля для управления ключами этого пользователя.
Назначение токенов различается: API управления использует токен доступа, API моделей — API Key. Не подменяйте их.
Первый запрос управления
Замените your-user-token токеном доступа и получите список ключей:
curl 'https://api.agtcloud.cn/api/token/?p=1&size=20' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer your-user-token'После успеха найдите Key в data.items и сохраните id для чтения деталей, обновления и удаления. Без записей items — пустой массив.
Поле key в списке/деталях может быть замаскировано и не подходит для вызовов модели. Полный секрет смотрите на странице API Keys.
Выбрать операцию
Откройте соответствующий Reference для параметров, примеров ответов или онлайн-проверки.
| Операция | Назначение |
|---|---|
| Список API Key | Просмотр ключей по страницам |
| Поиск API Key | Поиск по имени или значению ключа |
| Получить API Key | Чтение настроек по ID |
| Создать API Key | Имя, квота, срок и ограничения доступа |
| Обновить API Key | Изменение настроек или только включение/отключение |
| Удалить API Key | Удаление одного ключа |
| Пакетное удаление API Key | Удаление нескольких ключей |
Остаток конкретного ключа проверяется через Проверить квоту API Key с этим Key, а не с токеном доступа.
Меры предосторожности
Проверьте цели обновления и удаления
Обычное обновление может сбросить пропущенные поля. Прочитайте детали и передайте все настройки для сохранения. Для включения/отключения используйте отдельный режим обновления состояния.
Удаление влияет на зависимые приложения. Проверьте ID и не выполняйте удаление с ID из примера.
- Проверяйте бизнес-результат: HTTP
200может содержать ошибку. Проверяйте такжеsuccessиmessage. - Избегайте повторных записей: после тайм-аута создания, обновления или удаления сначала прочитайте результат; не повторяйте запрос сразу.
- Защищайте токены доступа: храните на управляемом сервере, не во frontend, публичных журналах, снимках и репозиториях. Не раскрывайте URL поиска с секретными значениями.