Konta zarządzane w CloudPrint Developer Platform
Konta zarządzane są przeznaczone dla produktów, które samodzielnie tworzą i obsługują osobne konta CloudPrint dla klientów. To jeden z modeli podłączenia w Developer Platform; stabilny kontrakt zarządzania nosi nazwę Partner API.
Wybierz właściwy proces
Gdy klient ma już konto CloudPrint, użyj App Installation zatwierdzanej przez właściciela. Konto zarządzane sprawdzi się we wbudowanym procesie lub rozwiązaniu pod własną marką, gdy konto tworzy Twój serwer. Do drukowania wyłącznie dla własnej firmy wybierz prostsze API Credentials.
Co jest wymagane
Dostęp do API wymaga Developer Account z aktywnym dostępem produkcyjnym, aktywnej Developer Application i ważnego klucza RS256. Za korzystanie z usługi produkcyjnej płaci organizacja Developer Account zgodnie z podpisaną umową handlową.
Zarejestruj adres powrotu
Dodaj dokładny adres powrotu 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 pod ten adres 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 i musi być unikalne w obrębie tej Developer Application. Inna aplikacja może użyć tej samej wartości dla własnego klienta. 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 nowe jednorazowe potwierdzenie JWT RS256 z aud=https://public-api.cloudprint.me/partner-api/v1 i wyślij je jako Authorization: Bearer <application_assertion>. Drukowanie korzysta z innego tokenu: pobierz Installation Access Token przez POST /developer-api/v1/app-installations/{installationId}/access-tokens, a następnie wywołuj /api/v1/*.
Obsługa klienta pozostaje w Twoim produkcie
Odpowiadasz za podłączenie klienta, powiązanie kont i pierwszą linię wsparcia. Pokazuj stan konta, agentów, drukarek i wykorzystanie usługi we własnym produkcie. Zapisuj X-Request-Id, ale nigdy nie umieszczaj w logach kluczy prywatnych, potwierdzeń JWT ani kodów Enrollment.
Uwzględnij limity i rozliczenia
Partner API dopuszcza 300 żądań z jednego adresu IP i 1 200 żądań jednej uwierzytelnionej aplikacji w ciągu 60 sekund. Po 429 stosuj Retry-After oraz nagłówki X-RateLimit-*. CloudPrint wystawia organizacji Developer Account miesięczną fakturę na uzgodnioną kwotę zamiast naliczać opłatę za każde zadanie. Nie ma miesięcznego limitu wykorzystania, o ile umowa nie stanowi inaczej; nadal obowiązują opublikowane limity częstotliwości żądań i zabezpieczenia kolejki.