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. ## Następne kroki