> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Создание API-учётных данных платформы AceDataCloud

> Platform API guide - Ace Data Cloud

Создайте бизнес-API-учётные данные для одного Application. Ответ на создание может содержать Token, который можно напрямую использовать для вызова `https://api.acedata.cloud/**`, или имя пользователя/пароль для учётных данных типа Proxy; их необходимо рассматривать как секреты.

## Подготовка

1. Создайте [Account Token](https://platform.acedata.cloud/documents/platform-token).
2. Получите принадлежащий вам `application_id` из [списка Application](https://platform.acedata.cloud/documents/platform-application-list).

```shell theme={null}
export PLATFORM_TOKEN='ваш токен аккаунта'
export APPLICATION_ID='ваш Application ID'
```

## Обзор интерфейса

| Пункт | Содержание |
| - | - |
| Метод | `POST` |
| URL | `https://platform.acedata.cloud/api/v1/credentials/` |
| Авторизация | Account Token, OAuth token должен иметь `credentials:write` |
| Body | JSON |

## Тело запроса

| Поле | Тип | Обязательно | Описание |
| - | - | - | - |
| `application_id` | UUID | Да | Целевой Application |
| `name` | string | Нет | Отображаемое имя учётных данных |
| `limited_amount` | number / null | Нет | Лимит использования одних учётных данных; `null` означает отсутствие отдельного лимита |
| `expired_at` | datetime / null | Нет | Время истечения срока действия в ISO 8601 |
| `allowed_api_ids` | UUID\[] / null | Нет | Разрешить вызов только этих API; пустой массив будет нормализован как отсутствие ограничений |
| `host` | string | Нет | Информация о host учётных данных |
| `for_user_id` | string | Нет | Используется, когда владелец Application выдаёт авторизационные учётные данные для другого пользователя |
| `tags` / `metadata` | array / object | Нет | Пользовательские расширенные данные |

```shell theme={null}
curl -X POST 'https://platform.acedata.cloud/api/v1/credentials/' \
  -H "Authorization: Bearer ${PLATFORM_TOKEN}" \
  -H 'Content-Type: application/json' \
  -d "{\"application_id\":\"${APPLICATION_ID}\",\"name\":\"production\",\"limited_amount\":50}"
```

## Описание ответа

При успехе возвращается `201` и объект Credential:

* Сервисы типа API/Agent обычно возвращают `type=Token` и `token`;
* Сервисы типа Proxy обычно возвращают `type=Identity` и `username` / `password`, при этом для одного Proxy Application допускается только один набор учётных данных;
* `id`, `user_id`, `creator_id`, `used_amount` и поля времени генерируются сервером.

Текущие интерфейсы списка и деталей также возвращают открытые значения учётных данных, но клиент не должен полагаться на это историческое поведение. Сохраните их сразу после создания, избегайте записи ответа в логи; в будущем интерфейсы могут быть изменены на возврат замаскированных значений.

## Обработка ошибок

* `400`: ошибка формата поля, неизвестные `allowed_api_ids`, Proxy Application уже имеет учётные данные или другие ограничения создания.
* `401`: Account Token недействителен.
* `403/404`: нет прав доступа к целевому Application либо Application/авторизованный пользователь не существует.

## Следующие шаги

* [Получить список API-учётных данных](https://platform.acedata.cloud/documents/platform-credential-list)
* [Ротировать API-учётные данные](https://platform.acedata.cloud/documents/platform-credential-rotate)
* [Удалить API-учётные данные](https://platform.acedata.cloud/documents/platform-credential-delete)
* [Просмотреть записи вызовов](https://platform.acedata.cloud/documents/platform-usage-list)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.