Dokumentacja CloudPrint/Dokumentacja API

Pobierz Agent Enrollments

Pobierz pending, claimed, expired i revoked Agent Enrollments bez tajnych kodów.

GET/partner-api/v1/accounts/{relationshipId}/agent-enrollmentsWersja API: v1operationId: listPartnerAgentEnrollmentsOtwórz w Markdown

Działanie metody

Pobierz pending, claimed, expired i revoked Agent Enrollments bez tajnych kodów.

Uwierzytelnianie

Przekaż jednorazowy assertion RS256 Developer Application w Authorization: Bearer <application_assertion>. Nie jest to token dostępu do Public API.

Żądanie

Podstawowy adres API: https://public-api.cloudprint.me/partner-api/v1/accounts/{relationshipId}/agent-enrollments

Parametry

Nazwa	Położenie	Typ	Wymagane	Opis	Ograniczenia
relationshipId	path	string (uuid)	tak	Pole kontraktu API; uwzględnij podany typ i ograniczenia.	—
limit	query	integer	nie	Pole kontraktu API; uwzględnij podany typ i ograniczenia.	min: 1; max: 100; default: 50
cursor	query	string	nie	Pole kontraktu API; uwzględnij podany typ i ograniczenia.	—

Treść żądania

Metoda nie ma treści żądania.

Przykładowe żądania

cURL

curl -sS "https://public-api.cloudprint.me/partner-api/v1/accounts/$RELATIONSHIP_ID/agent-enrollments" \
  -H "Authorization: Bearer $APPLICATION_ASSERTION"

Odpowiedź

Status HTTP: 200 — Żądanie zostało wykonane.

Pola odpowiedzi

Nazwa	Typ	Wymagane	Opis	Ograniczenia
data	array	tak	Pole kontraktu API; uwzględnij podany typ i ograniczenia.	—
next_cursor	string | null	tak	Nieprzezroczysty kursor następnej strony; przekaż go bez zmian.	—

Przykładowa odpowiedź

{
  "data": [
    {
      "agent_enrollment_id": "11111111-1111-4111-8111-111111111111",
      "name": "string",
      "status": "pending",
      "expires_at": "2026-08-06T12:00:00Z",
      "created_at": "2026-08-06T12:00:00Z",
      "agent_id": null,
      "claimed_at": null,
      "revoked_at": null
    }
  ],
  "next_cursor": null
}

Błędy

Status HTTP	Opis
401	Brak uwierzytelnienia albo jest ono nieprawidłowe.
403	Brak uprawnień wymaganych do tej operacji.
404	Nie znaleziono żądanego zasobu.
422	Pola żądania nie przeszły walidacji.
429	Przekroczono limit żądań; zastosuj Retry-After.
500	Wewnętrzny błąd CloudPrint.

Wskazówki integracyjne

Powiązana dokumentacja

Utwórz Agent EnrollmentWydaj idempotentny jednorazowy Enrollment przed lub po onboardingu klienta.Pobierz jedno Agent EnrollmentSprawdź konkretną jednorazową rejestrację zarządzanego klienta i powiąż ją z podłączonym Agentem.Rejestracja agenta klientaPołącz lokalnego agenta CloudPrint z właściwym zarządzanym kontem bez logowania klienta do panelu CloudPrint.

OpenAPIOtwórz panelPolityka prywatnościRegulaminPłatności i zwrotyDPA