Verwaltete Kundenkonten auflisten

Rufen Sie die von der authentifizierten Partneranwendung bereitgestellten Kundenkonten einschließlich Agent- und Druckerstatus ab.

GET/partner-api/v1/accountsAPI-Version: v1operationId: listPartnerManagedAccountsAls Markdown anzeigen

Funktion dieser Methode

Rufen Sie die von der authentifizierten Partneranwendung bereitgestellten Kundenkonten einschließlich Agent- und Druckerstatus ab.

Authentifizierung

Senden Sie eine einmalige RS256-Assertion der Developer Application in Authorization: Bearer <application_assertion>. Sie ist kein Public-API-Zugriffstoken.

Anfrage

Produktions-URL: https://public-api.cloudprint.me/partner-api/v1/accounts

Parameter

Name	Position	Typ	Erforderlich	Beschreibung	Einschränkungen
`limit`	query	`integer`	nein	Höchstzahl der Ressourcen auf einer Ergebnisseite.	min: 1; max: 100; default: `50`
`cursor`	query	`string (uuid)`	nein	Opaker Cursor der angefragten Ergebnisseite; senden Sie ihn unverändert zurück.	—
`external_customer_id`	query	`string`	nein	Stabile Kennung, die der Integrator dem Kunden im eigenen System zuordnet.	minLength: 1; maxLength: 160
`X-Request-Id`	header	`string`	nein	Optionale Kennung zur Anfrageverfolgung; CloudPrint gibt einen sicheren Wert im Antwort-Header zurück.	maxLength: 128; example: `"order-100045-attempt-1"`

Anfrageinhalt

Die Methode hat keinen Anfrageinhalt.

Anfragebeispiele

cURL

bash

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

Antwort

HTTP-Status: 200 — Anfrage erfolgreich.

Antwortfelder

Name	Typ	Erforderlich	Beschreibung	Einschränkungen
`data`	`array`	ja	Ressourcen auf der aktuellen Ergebnisseite.	—
`next_cursor`	`string \| null (uuid)`	ja	Opaker Cursor für die nächste Ergebnisseite; senden Sie ihn unverändert zurück.	—

Beispielantwort

json

{
  "data": [
    {
      "health": {
        "agent_count": 0,
        "online_agent_count": 0,
        "printer_count": 0,
        "online_printer_count": 0,
        "last_seen_at": "2026-08-06T12:00:00Z"
      },
      "relationship_id": "11111111-1111-4111-8111-111111111111",
      "developer_account_id": "11111111-1111-4111-8111-111111111111",
      "cloudprint_account_id": "11111111-1111-4111-8111-111111111111",
      "external_customer_id": "string",
      "name": "string",
      "application_id": "11111111-1111-4111-8111-111111111111",
      "installation_id": "11111111-1111-4111-8111-111111111111",
      "agent_enrollment_id": "11111111-1111-4111-8111-111111111111",
      "agent_onboarding_expires_at": "2026-08-06T12:00:00Z",
      "agent_onboarding_url": "https://connect.cloudprint.me/setup#token=cpat_example",
      "onboarding_status": "provisioning",
      "status": "provisioning",
      "created_at": "2026-08-06T12:00:00Z",
      "updated_at": "2026-08-06T12:00:00Z"
    }
  ],
  "next_cursor": "11111111-1111-4111-8111-111111111111"
}

Fehler

HTTP-Status	Beschreibung
`401`	Authentifizierung fehlt oder ist ungültig.
`403`	Das Token hat nicht die erforderlichen Berechtigungen.
`422`	Mindestens ein Feld ist ungültig.
`429`	Anfragelimit überschritten; beachten Sie Retry-After.
`500`	Interner CloudPrint-Fehler.

Verwaltete Kundenkonten auflisten ​

Funktion dieser Methode ​

Authentifizierung ​

Anfrage ​

Parameter ​

Anfrageinhalt ​

Anfragebeispiele ​

cURL ​

Antwort ​

Antwortfelder ​

Beispielantwort ​

Fehler ​

Verwandte Dokumentation ​