---
title: "Создать управляемый аккаунт клиента"
description: "Создайте изолированный аккаунт CloudPrint, App Installation и одноразовое подключение агента без регистрации клиента."
---
# Создать управляемый аккаунт клиента
Создайте изолированный аккаунт CloudPrint, App Installation и одноразовое подключение агента без регистрации клиента.
POST/partner-api/v1/accountsВерсия API: v1operationId: createPartnerManagedAccountОткрыть в Markdown
## Назначение метода
Создайте изолированный аккаунт CloudPrint, App Installation и одноразовое подключение агента без регистрации клиента.
## Авторизация
Передавайте одноразовое JWT-подтверждение Developer Application, подписанное RS256, в `Authorization: Bearer `. Это не токен доступа к Public API.
## Запрос
**Основной адрес API:** `https://public-api.cloudprint.me/partner-api/v1/accounts`
### Параметры
| Имя | Расположение | Тип | Обязательно | Описание | Ограничения |
| --- | --- | --- | --- | --- | --- |
| `Idempotency-Key` | header | `string` | да | Поле контракта API; учитывайте указанные тип и ограничения. | minLength: 1; maxLength: 200 |
### Тело запроса
**Тип содержимого:** `application/json`
| Имя | Тип | Обязательно | Описание | Ограничения |
| --- | --- | --- | --- | --- |
| `external_customer_id` | `string` | да | Стабильный идентификатор этого ресурса. | minLength: 1; maxLength: 160; example: `"customer-42"` |
| `name` | `string` | да | Поле контракта API; учитывайте указанные тип и ограничения. | minLength: 1; maxLength: 120; example: `"Acme Store 42"` |
| `permissions` | `array` | нет | Разрешения установки, включённые в этот токен. | — |
| `agent_onboarding` | `object` | да | Поле контракта API; учитывайте указанные тип и ограничения. | — |
### Примеры запросов
#### cURL
```bash
curl -sS https://public-api.cloudprint.me/partner-api/v1/accounts \
-H "Authorization: Bearer $APPLICATION_ASSERTION" \
-H 'Idempotency-Key: customer-42-provision-v1' \
-H 'Content-Type: application/json' \
-d '{
"external_customer_id": "customer-42",
"name": "Acme Store 42",
"permissions": ["printers:read", "documents:write", "print_jobs:write", "print_jobs:read"],
"agent_onboarding": {
"return_uri": "https://app.integrator.example/cloudprint/callback",
"state": "single-use-random-state"
}
}'
```
## Ответ
**HTTP-статус:** `200` — Запрос выполнен.
### Поля ответа
| Имя | Тип | Обязательно | Описание | Ограничения |
| --- | --- | --- | --- | --- |
| `relationship_id` | `string (uuid)` | да | Стабильный идентификатор этого ресурса. | — |
| `developer_account_id` | `string (uuid)` | да | Стабильный идентификатор этого ресурса. | — |
| `cloudprint_account_id` | `string (uuid)` | да | Стабильный идентификатор этого ресурса. | — |
| `external_customer_id` | `string` | да | Стабильный идентификатор этого ресурса. | maxLength: 160 |
| `name` | `string` | да | Поле контракта API; учитывайте указанные тип и ограничения. | maxLength: 120 |
| `application_id` | `string (uuid)` | да | Стабильный идентификатор Developer Application, представленного токеном установки. | — |
| `installation_id` | `string \| null (uuid)` | да | Стабильный UUID App Installation, выдавшей разрешение токену. | — |
| `agent_enrollment_id` | `string \| null (uuid)` | да | Стабильный идентификатор Agent Enrollment. | — |
| `agent_onboarding_expires_at` | `string \| null (date-time)` | да | Временная метка CloudPrint в формате ISO 8601. | — |
| `agent_onboarding_url` | `string \| null (uri)` | да | Основная одноразовая ссылка для подключения агента. Открывайте её целиком, не изменяйте и не записывайте в логи. | example: `"https://connect.cloudprint.me/setup#token=cpat_example"` |
| `onboarding_status` | `string` | да | Поле контракта API; учитывайте указанные тип и ограничения. | enum: `provisioning`, `waiting_for_agent`, `ready`, `failed` |
| `status` | `string` | да | Текущее состояние ресурса или процесса; учитывайте допустимые значения конкретного метода. | enum: `provisioning`, `active`, `suspended`, `closed` |
| `created_at` | `string (date-time)` | да | Временная метка CloudPrint в формате ISO 8601. | — |
| `updated_at` | `string (date-time)` | да | Временная метка CloudPrint в формате ISO 8601. | — |
### Пример ответа
```json
{
"relationship_id": "11111111-1111-4111-8111-111111111111",
"developer_account_id": "11111111-1111-4111-8111-111111111111",
"cloudprint_account_id": "11111111-1111-4111-8111-111111111111",
"external_customer_id": "string",
"name": "string",
"application_id": "11111111-1111-4111-8111-111111111111",
"installation_id": null,
"agent_enrollment_id": null,
"agent_onboarding_expires_at": null,
"agent_onboarding_url": "https://connect.cloudprint.me/setup#token=cpat_example",
"onboarding_status": "provisioning",
"status": "provisioning",
"created_at": "2026-08-06T12:00:00Z",
"updated_at": "2026-08-06T12:00:00Z"
}
```
## Ошибки
| HTTP-статус | Описание |
| --- | --- |
| `401` | Авторизация отсутствует или недействительна. |
| `403` | Для операции недостаточно разрешений. |
| `404` | Запрошенный ресурс не найден. |
| `409` | Запрос конфликтует с текущим состоянием ресурса. |
| `422` | Поля запроса не прошли проверку. |
| `429` | Превышен лимит запросов; учитывайте Retry-After. |
| `500` | Внутренняя ошибка CloudPrint. |
## Рекомендации по интеграции
## Связанная документация