Verwaltetes Kundenkonto bereitstellen

Erstellen Sie ohne Kundenregistrierung ein isoliertes CloudPrint-Konto, eine App Installation und ein einmaliges Agent Enrollment.

POST/partner-api/v1/accountsAPI-Version: v1operationId: createPartnerManagedAccountAls Markdown anzeigen

Funktion dieser Methode

Erstellen Sie ohne Kundenregistrierung ein isoliertes CloudPrint-Konto, eine App Installation und ein einmaliges Agent Enrollment.

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
`Idempotency-Key`	header	`string`	ja	Stabiler, vom Client erzeugter Schlüssel, damit Wiederholungen das ursprüngliche Ergebnis liefern und kein Duplikat erstellen.	minLength: 1; maxLength: 200
`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

Inhaltstyp: application/json

Name	Typ	Erforderlich	Beschreibung	Einschränkungen
`external_customer_id`	`string`	ja	Stabile Kennung, die der Integrator dem Kunden im eigenen System zuordnet.	minLength: 1; maxLength: 160; example: `"customer-42"`
`name`	`string`	ja	Anzeigename der Ressource für die Kontobetreiber.	minLength: 1; maxLength: 120; example: `"Acme Store 42"`
`permissions`	`array`	nein	Für die App Installation genehmigte Berechtigungen.	—
`agent_onboarding`	`object`	ja	Einmalige Verbindungsdaten für den Agenten des verwalteten Kunden.	—

Anfragebeispiele

cURL

bash

curl -sS https://public-api.cloudprint.me/partner-api/v1/accounts \
  -H "Authorization: Bearer $APPLICATION_ASSERTION" \
  -H 'Idempotency-Key: customer-42-provision-v1' \
  -H 'Content-Type: application/json' \
  -d '{
    "external_customer_id": "customer-42",
    "name": "Acme Store 42",
    "permissions": ["printers:read", "documents:write", "print_jobs:write", "print_jobs:read"],
    "agent_onboarding": {
      "return_uri": "https://app.integrator.example/cloudprint/callback",
      "state": "single-use-random-state"
    }
  }'

Antwort

HTTP-Status: 200 — Anfrage erfolgreich.

Antwortfelder

Name	Typ	Erforderlich	Beschreibung	Einschränkungen
`relationship_id`	`string (uuid)`	ja	Stabile UUID der Beziehung zwischen Partner und verwaltetem Kunden.	—
`developer_account_id`	`string (uuid)`	ja	Stabile UUID des Entwicklerkontos, dem die Kundenbeziehung gehört.	—
`cloudprint_account_id`	`string (uuid)`	ja	Stabile UUID des CloudPrint-Kontos für den verwalteten Kunden.	—
`external_customer_id`	`string`	ja	Stabile Kennung, die der Integrator dem Kunden im eigenen System zuordnet.	maxLength: 160
`name`	`string`	ja	Anzeigename der Ressource für die Kontobetreiber.	maxLength: 120
`application_id`	`string (uuid)`	ja	Stabile Kennung der Developer Application, die mit der Ressource verknüpft ist.	—
`installation_id`	`string \| null (uuid)`	ja	Stabile UUID der App Installation, die mit der Ressource verknüpft ist.	—
`agent_enrollment_id`	`string \| null (uuid)`	ja	Stabile Kennung des Agent Enrollments.	—
`agent_onboarding_expires_at`	`string \| null (date-time)`	ja	Von CloudPrint erfasster ISO-8601-Zeitstempel.	—
`agent_onboarding_url`	`string \| null (uri)`	ja	Kanonischer Einmal-Link zum Verbinden eines Agenten. Öffnen Sie ihn vollständig und unverändert und schreiben Sie ihn nicht in Protokolldateien.	example: `"https://connect.cloudprint.me/setup#token=cpat_example"`
`onboarding_status`	`string`	ja	Aktueller Bereitschaftsstatus der CloudPrint-Einrichtung des verwalteten Kunden.	enum: `provisioning`, `waiting_for_agent`, `ready`, `failed`
`status`	`string`	ja	Aktueller Ressourcen- oder Prozessstatus; verwenden Sie die Enum-Werte der jeweiligen Methode.	enum: `provisioning`, `active`, `suspended`, `closed`
`created_at`	`string (date-time)`	ja	Von CloudPrint erfasster ISO-8601-Zeitstempel.	—
`updated_at`	`string (date-time)`	ja	Von CloudPrint erfasster ISO-8601-Zeitstempel.	—

Beispielantwort

json

{
  "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"
}

Fehler

HTTP-Status	Beschreibung
`401`	Authentifizierung fehlt oder ist ungültig.
`403`	Das Token hat nicht die erforderlichen Berechtigungen.
`404`	Ressource nicht gefunden.
`409`	Die Anfrage widerspricht dem aktuellen Zustand.
`422`	Mindestens ein Feld ist ungültig.
`429`	Anfragelimit überschritten; beachten Sie Retry-After.
`500`	Interner CloudPrint-Fehler.

Verwaltetes Kundenkonto bereitstellen ​

Funktion dieser Methode ​

Authentifizierung ​

Anfrage ​

Parameter ​

Anfrageinhalt ​

Anfragebeispiele ​

cURL ​

Antwort ​

Antwortfelder ​

Beispielantwort ​

Fehler ​

Verwandte Dokumentation ​