--- title: "Partner Platform CloudPrint" description: "Создавайте отдельные аккаунты CloudPrint для клиентов и управляйте ими из своего продукта." --- # Partner Platform CloudPrint

Partner Platform подходит продуктам, которые сами создают и обслуживают отдельные аккаунты CloudPrint для клиентов. Клиенту не нужно регистрироваться в CloudPrint, но вашему продукту по-прежнему нужны Developer Application и App Installation.

## Когда выбирать Partner Platform Developer Platform подходит клиентам, у которых уже есть аккаунт CloudPrint и которые сами подтверждают установку. Partner Platform нужна, когда создание аккаунта встроено в ваш продукт или работает под вашим брендом. Если вы печатаете только для своей компании, используйте более простой вариант с [API Credentials](../api/authentication/). ## Что нужно для доступа Для работы API нужны активные Developer Account и Developer Application с действующим ключом RS256, а также участие в Partner Program. Использование в рабочей среде оплачивает организация партнёра по подписанному коммерческому соглашению. ## Зарегистрируйте адрес возврата Добавьте точный адрес возврата в `redirect_uri` Developer Application и передавайте то же значение в `agent_onboarding.return_uri` при создании аккаунта или Enrollment. После подключения CloudPrint вернёт оператора на этот адрес с исходным `state`; проверьте его перед обработкой результата. ## Что создаётся для клиента Один запрос создаёт отдельный CloudPrint Account, App Installation вашего приложения и Partner Account Relationship. Поле `external_customer_id` связывает запись с клиентом. Сохраняйте `relationship_id` для управления клиентом через Partner API и `installation_id` для выпуска токенов Print API. `cloudprint_account_id` остаётся доступным только для сверки. ## Разделяйте управление и печать Для каждого запроса `/partner-api/v1/*` подписывайте новое одноразовое JWT-подтверждение RS256 с `aud=https://public-api.cloudprint.me/partner-api/v1` и передавайте его как `Authorization: Bearer `. Для печати используется другой токен: получите Installation Access Token через `POST /developer-api/v1/app-installations/{installationId}/access-tokens`, а затем вызывайте `/api/v1/*`. ## Поддержка клиента остаётся в вашем продукте Вы отвечаете за подключение, связь с клиентом и первую линию поддержки. Показывайте в своём продукте состояние аккаунта, агентов, принтеров и статистику использования. Сохраняйте `X-Request-Id`, но никогда не записывайте в логи закрытые ключи, JWT-подтверждения или коды Enrollment. ## Учитывайте лимиты и условия оплаты Partner API допускает 300 запросов с одного IP-адреса и 1 200 запросов одного авторизованного приложения за 60 секунд. При `429` учитывайте `Retry-After` и заголовки `X-RateLimit-*`. CloudPrint ежемесячно выставляет организации партнёра фиксированный счёт. Количество управляемых аккаунтов, агентов и заданий печати не ограничено, если соглашение не устанавливает иное. ## Чек-лист перед запуском - Используйте исходящее подключение агента и не открывайте порты принтера в интернет. - Сохраняйте стабильный идентификатор принтера, а не только отображаемое имя. - Проверяйте формат документа, размер страницы и ориентацию до создания задания. - Явно задайте обработку конечных статусов, повторов и защиту от двойной печати. ## Следующие шаги
Создание и управление аккаунтами клиентовАвторизуйте запросы Partner API, создавайте аккаунты клиентов, приостанавливайте, возобновляйте или закрывайте их. Подключение агента клиентаПодключите локальный CloudPrint Agent к правильному управляемому аккаунту без входа клиента в кабинет CloudPrint. Developer Platform CloudPrintСоздайте одно приложение, которое клиенты смогут подключать к своим аккаунтам CloudPrint.