Partner Platform CloudPrint
Partner Platform подходит продуктам, которые сами создают и обслуживают отдельные аккаунты CloudPrint для клиентов. Клиенту не нужно регистрироваться в CloudPrint, но вашему продукту по-прежнему нужны Developer Application и App Installation.
Когда выбирать Partner Platform
Developer Platform подходит клиентам, у которых уже есть аккаунт CloudPrint и которые сами подтверждают установку. Partner Platform нужна, когда создание аккаунта встроено в ваш продукт или работает под вашим брендом. Если вы печатаете только для своей компании, используйте более простой вариант с API Credentials.
Что нужно для доступа
Для работы API нужны активные Developer Account и Developer Application с действующим ключом RS256, а также активное участие в Partner Program. Использование в production оплачивает организация партнёра по подписанному коммерческому соглашению.
Зарегистрируйте callback подключения
Добавьте точный callback как redirect_uri Developer Application и передавайте то же значение в agent_onboarding.return_uri при создании аккаунта или Enrollment. CloudPrint вернёт оператора на этот callback с исходным 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/* подписывайте новый одноразовый RS256 assertion с aud=https://public-api.cloudprint.me/partner-api/v1 и передавайте Authorization: Bearer <application_assertion>. Для печати нужен другой credential: получите Installation Access Token через POST /developer-api/v1/app-installations/{installationId}/access-tokens и вызывайте /api/v1/*.
Поддержка клиента остаётся в вашем продукте
Вы отвечаете за onboarding, связь с клиентом и первую линию поддержки. Показывайте health relationship, Agents, принтеры и usage в своём продукте, сохраняйте X-Request-Id и никогда не записывайте private key, assertion или Enrollment code в логи.
Учитывайте лимиты и коммерческий статус
Partner API допускает 300 запросов с одного source IP и 1 200 запросов одного authenticated Application за 60 секунд. При 429 следуйте Retry-After и заголовкам X-RateLimit-*. CloudPrint ежемесячно выставляет организации партнёра фиксированный счёт; managed accounts, Agents и print jobs не ограничены, если соглашение не устанавливает иное.
Чек-лист перед запуском
- Используйте исходящее подключение агента и не открывайте порты принтера в интернет.
- Сохраняйте стабильный идентификатор принтера, а не только отображаемое имя.
- Проверяйте формат документа, размер страницы и ориентацию до создания задания.
- Явно задайте обработку конечных статусов, повторов и защиту от двойной печати.