Konfiguracja agenta dla konta zarządzanego
Agent Enrollment łączy jednego lub wielu lokalnych CloudPrint Agents z właściwym kontem klienta bez rejestracji i logowania klienta do CloudPrint.
Bezpiecznie ponawiaj tworzenie Enrollment
Podczas tworzenia konta CloudPrint zwraca agent_onboarding_url. Kolejny komputer możesz dodać przez POST /partner-api/v1/accounts/{relationshipId}/agent-enrollments z wymaganym Idempotency-Key. Dokładne ponowienie zwraca ten sam Enrollment ID, termin ważności i link. Przed pierwszym żądaniem zapisz klucz, state, nazwę, adres powrotu i opcjonalne replaces_enrollment_id; przy ponowieniu zmienia się tylko potwierdzenie aplikacji. Aby zastąpić znany, niewykorzystany Enrollment, przekaż replaces_enrollment_id.
Śledź dokładnie ten Enrollment
Zapisz zwrócony agent_enrollment_id i sprawdzaj GET /partner-api/v1/accounts/{relationshipId}/agent-enrollments/{enrollmentId}. Kontynuuj przy statusie pending; gdy zmieni się na claimed, zapisz zwrócony agent_id. Zakończ przy expired lub revoked. Odpowiedzi GET i listy nie zwracają ponownie poufnego linku do podłączenia, dlatego odpowiedź na utworzenie przechowuj bezpiecznie do końca procesu. Dzięki temu wcześniej podłączony Agent nie zostanie pomylony z komputerem korzystającym z nowego linku.
Wyświetlaj i odwołuj Enrollment
GET /partner-api/v1/accounts/{relationshipId}/agent-enrollments zwraca wpisy o statusach pending, claimed, expired i revoked bez poufnych kodów. Odwołaj nieużyty kod przez DELETE /partner-api/v1/accounts/{relationshipId}/agent-enrollments/{enrollmentId}. Ponowienie odwołania jest bezpieczne.
Wyświetlaj i odwołuj agentów
Pokaż podłączone komputery przez GET /partner-api/v1/accounts/{relationshipId}/agents. Utracony, uszkodzony lub wymieniony komputer odwołaj przez DELETE /partner-api/v1/accounts/{relationshipId}/agents/{agentId}, a dla nowego utwórz Enrollment. Drukarki odwołanego agenta przejdą w stan offline.
Odzyskaj utraconą odpowiedź
Powtórz dokładne żądanie z nowym jednorazowym potwierdzeniem i tym samym Idempotency-Key dla Enrollment. Dopóki przechowywany jest zapis idempotencji, CloudPrint zwróci pierwotny link do podłączenia. Inna treść lub ścieżka z tym samym kluczem zwraca 409 partner.idempotency.conflict; po odpowiedzi o nieznanym wyniku nie twórz nowego klucza.
Otwórz stronę podłączenia
Otwórz pełny agent_onboarding_url wraz z fragmentem #token bez zmian. Nie analizuj, nie modyfikuj, nie przekazuj przez proxy ani nie zapisuj tego adresu w logach. Katalog instalatorów jest dostępny przez GET /agent-download-api/v1/releases, a plik przez GET /agent-download-api/v1/installers/{filename}. Po powrocie sprawdź state. result=ready potwierdza pierwszy uwierzytelniony heartbeat agenta, a nie dostępność drukarki. Odśwież zarządzane konto, agentów i listę drukarek; włącz drukowanie dopiero przy status=active, online_agent_count > 0 i online_printer_count > 0.
Zbierz dane dla wsparcia
Przechowuj identyfikator klienta, relationship_id, installation_id, Enrollment ID, Agent ID, wersję agenta, czas ostatniej aktywności i powiązane wartości X-Request-Id. Te dane pozwolą rozróżnić problem z kontem, Enrollment, połączeniem agenta, wykrywaniem drukarki lub Print API bez proszenia o dane dostępowe.