CloudPrint Partner Platform
Partner Platform jest przeznaczona dla produktów, które samodzielnie tworzą i obsługują osobne konta CloudPrint dla klientów. Klient nie musi rejestrować się w CloudPrint, ale Twój produkt nadal korzysta z Developer Application i App Installation.
Kiedy wybrać Partner Platform
Developer Platform służy klientom, którzy mają już konto CloudPrint i sami zatwierdzają instalację. Partner Platform jest właściwa, gdy tworzenie konta jest częścią Twojego produktu lub działa pod Twoją marką. Jeśli drukujesz tylko dla własnej firmy, wybierz prostsze API Credentials.
Co jest wymagane
Dostęp do API wymaga aktywnych Developer Account i Developer Application, ważnego klucza RS256 oraz aktywnego udziału w Partner Program. Za użycie produkcyjne rozliczana jest organizacja partnera zgodnie z podpisaną umową handlową.
Zarejestruj callback podłączenia
Dodaj dokładny callback jako redirect_uri Developer Application, a następnie przekaż tę samą wartość w agent_onboarding.return_uri podczas tworzenia konta lub Enrollment. CloudPrint odeśle operatora do tego callbacku z pierwotnym state; zweryfikuj go przed przyjęciem wyniku.
Co powstaje dla klienta
Jedno żądanie tworzy osobne CloudPrint Account, App Installation Twojej aplikacji i Partner Account Relationship. Pole external_customer_id łączy rekord z klientem. Zapisz relationship_id do zarządzania klientem przez Partner API oraz installation_id do wydawania tokenów Print API. cloudprint_account_id służy tylko do weryfikacji.
Oddziel zarządzanie od drukowania
Dla każdego żądania /partner-api/v1/* podpisz nowy jednorazowy assertion RS256 z aud=https://public-api.cloudprint.me/partner-api/v1 i wyślij Authorization: Bearer <application_assertion>. Drukowanie używa innego credential: pobierz Installation Access Token przez POST /developer-api/v1/app-installations/{installationId}/access-tokens, a potem wywołuj /api/v1/*.
Obsługa klienta pozostaje w Twoim produkcie
Odpowiadasz za onboarding, mapowanie klienta i pierwszą linię wsparcia. Pokazuj health relacji, Agents, drukarki i usage we własnym produkcie, zapisuj X-Request-Id i nigdy nie loguj private key, assertions ani kodów Enrollment.
Uwzględnij limity i stan handlowy
Partner API dopuszcza 300 żądań z jednego source IP i 1 200 żądań uwierzytelnionej Application w oknie 60 sekund. Po 429 stosuj Retry-After oraz nagłówki X-RateLimit-*. CloudPrint wystawia partnerowi miesięczną fakturę o stałej kwocie; managed accounts, Agents i print jobs są nielimitowane, jeśli umowa nie stanowi inaczej.
Lista kontrolna przed wdrożeniem
- Korzystaj z wychodzącego połączenia agenta; nie wystawiaj portów drukarki do internetu.
- Zapisuj stabilny identyfikator drukarki, a nie tylko jej nazwę.
- Sprawdzaj format dokumentu, rozmiar strony i orientację przed utworzeniem zadania.
- Jawnie obsługuj status końcowy, ponowienia i ochronę przed podwójnym drukiem.