{ "components": { "schemas": { "Checkout": { "allOf": [ { "$ref": "#/components/schemas/Order" }, { "properties": { "checkout_url": { "format": "uri", "type": "string" }, "fulfillment": { "type": "string" } }, "required": [ "fulfillment" ], "type": "object" } ] }, "Credential": { "properties": { "license_key": { "description": "Nur für das offizielle SDK; Zugriff niemals durch Prüfung dieses Werts autorisieren.", "type": "string", "x-sensitive": true }, "product_id": { "format": "uuid", "type": "string" }, "valid_until": { "format": "date-time", "type": [ "string", "null" ] }, "version": { "minimum": 1, "type": "integer" } }, "required": [ "product_id", "license_key", "valid_until", "version" ], "type": "object" }, "EntitlementStatus": { "properties": { "account_url": { "format": "uri", "type": "string" }, "code": { "type": "string" }, "environment": { "enum": [ "sandbox", "live" ], "type": "string" }, "max_retry_attempts": { "minimum": 0, "type": "integer" }, "message": { "type": "string" }, "next_action": { "type": "string" }, "product_id": { "format": "uuid", "type": "string" }, "retry_after_seconds": { "minimum": 0, "type": "integer" }, "status": { "enum": [ "ready", "pending", "expired", "suspended", "not_purchased" ], "type": "string" }, "synchronized": { "type": "boolean" }, "valid_from": { "format": "date-time", "type": [ "string", "null" ] }, "valid_until": { "format": "date-time", "type": [ "string", "null" ] } }, "required": [ "product_id", "environment", "status", "code", "message", "next_action", "account_url", "synchronized", "retry_after_seconds", "max_retry_attempts" ], "type": "object" }, "Error": { "properties": { "error": { "properties": { "code": { "type": "string" }, "message": { "type": "string" } }, "required": [ "code", "message" ], "type": "object" }, "request_id": { "$ref": "#/components/schemas/RequestID" } }, "required": [ "error", "request_id" ], "type": "object" }, "ExternalCapabilities": { "additionalProperties": false, "properties": { "connection_ref": { "pattern": "^[A-Za-z0-9_.-]{1,128}$", "type": "string" }, "delivery_types": { "items": { "enum": [ "license_key", "activation_url", "instructions" ], "type": "string" }, "minItems": 1, "type": "array" }, "devices": { "const": false, "type": "boolean" }, "environment": { "enum": [ "sandbox", "live" ], "type": "string" }, "identity_exchange": { "const": false, "type": "boolean" }, "protocol": { "const": "launch-external-licensing-v1", "type": "string" }, "purchase_types": { "items": { "enum": [ "perpetual", "fixed_term" ], "type": "string" }, "minItems": 1, "type": "array" } }, "required": [ "protocol", "connection_ref", "environment", "purchase_types", "delivery_types" ], "type": "object" }, "ExternalCapabilitiesResponse": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/ExternalCapabilities" }, "request_id": { "type": "string" } }, "required": [ "data" ], "type": "object" }, "ExternalConnection": { "additionalProperties": false, "properties": { "activation_origins": { "items": { "format": "uri", "type": "string" }, "type": "array" }, "allow_local_http": { "type": "boolean" }, "allow_private_network": { "type": "boolean" }, "base_url": { "format": "uri", "type": "string" }, "capabilities": { "$ref": "#/components/schemas/ExternalCapabilities" }, "connection_ref": { "pattern": "^[A-Za-z0-9_.-]{1,128}$", "type": "string" }, "credential_stored": { "type": "boolean" }, "environment": { "enum": [ "sandbox", "live" ], "type": "string" }, "id": { "format": "uuid", "type": "string" }, "key_id": { "type": "string" }, "last_check_error": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "last_checked_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "name": { "type": "string" }, "provider": { "const": "custom_http", "type": "string" } }, "required": [ "id", "provider", "name", "base_url", "environment", "connection_ref", "key_id", "credential_stored", "allow_private_network", "allow_local_http", "activation_origins", "capabilities", "last_checked_at", "last_check_error" ], "type": "object" }, "ExternalConnectionInput": { "additionalProperties": false, "properties": { "activation_origins": { "items": { "format": "uri", "type": "string" }, "type": "array" }, "allow_local_http": { "default": false, "description": "Nur sandbox-Loopback-HTTP ist erlaubt.", "type": "boolean" }, "allow_private_network": { "default": false, "type": "boolean" }, "base_url": { "format": "uri", "maxLength": 512, "type": "string" }, "connection_ref": { "pattern": "^[A-Za-z0-9_.-]{1,128}$", "type": "string" }, "environment": { "enum": [ "sandbox", "live" ], "type": "string" }, "key_id": { "maxLength": 64, "minLength": 1, "type": "string" }, "name": { "maxLength": 160, "minLength": 2, "type": "string" }, "provider": { "const": "custom_http", "type": "string" }, "signing_key": { "description": "Standard-Base64 von 32-128 zufälligen Bytes; bei Erstellung erforderlich, leer bewahrt den bestehenden Schlüssel bei Bearbeitung.", "maxLength": 180, "type": "string", "writeOnly": true } }, "required": [ "provider", "name", "base_url", "environment", "connection_ref", "key_id" ], "type": "object" }, "ExternalConnectionResponse": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/ExternalConnection" }, "request_id": { "type": "string" } }, "required": [ "data" ], "type": "object" }, "ExternalDelivery": { "additionalProperties": false, "properties": { "connection_ref": { "pattern": "^[A-Za-z0-9_.-]{1,128}$", "type": "string" }, "delivery": { "anyOf": [ { "$ref": "#/components/schemas/ExternalDeliveryValue" }, { "type": "null" } ] }, "entitlement_ref": { "pattern": "^[A-Za-z0-9_-]{1,128}$", "type": "string" }, "environment": { "enum": [ "sandbox", "live" ], "type": "string" }, "status": { "enum": [ "pending", "ready", "unavailable" ], "type": "string" }, "version": { "minimum": 1, "type": "integer" } }, "required": [ "connection_ref", "environment", "entitlement_ref", "version", "status", "delivery" ], "type": "object" }, "ExternalDeliveryResponse": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/ExternalDelivery" }, "request_id": { "type": "string" } }, "required": [ "data" ], "type": "object" }, "ExternalDeliveryValue": { "additionalProperties": false, "properties": { "expires_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "type": { "enum": [ "license_key", "activation_url", "instructions" ], "type": "string" }, "value": { "description": "Vertraulich; höchstens 4096 UTF-8-Bytes. Niemals protokollieren. Aktivierungs-URLs müssen einen konfigurierten HTTPS-Ursprung verwenden.", "maxLength": 4096, "type": "string" } }, "required": [ "type", "value", "expires_at" ], "type": "object" }, "ExternalError": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "type": "string" }, "message": { "type": "string" } }, "required": [ "code", "message" ], "type": "object" }, "request_id": { "type": "string" } }, "required": [ "error", "request_id" ], "type": "object" }, "ExternalMapping": { "additionalProperties": false, "properties": { "connection_id": { "format": "uuid", "type": "string" }, "environment": { "enum": [ "sandbox", "live" ], "type": "string" }, "plan_ref": { "pattern": "^[A-Za-z0-9_.-]{1,128}$", "type": "string" }, "product_ref": { "pattern": "^[A-Za-z0-9_.-]{1,128}$", "type": "string" }, "version_id": { "format": "uuid", "type": "string" } }, "required": [ "version_id", "environment", "connection_id", "product_ref", "plan_ref" ], "type": "object" }, "ExternalMappingInput": { "additionalProperties": false, "properties": { "plan_ref": { "pattern": "^[A-Za-z0-9_.-]{1,128}$", "type": "string" }, "product_ref": { "pattern": "^[A-Za-z0-9_.-]{1,128}$", "type": "string" }, "version_id": { "format": "uuid", "type": "string" } }, "required": [ "version_id", "product_ref", "plan_ref" ], "type": "object" }, "ExternalReceipt": { "additionalProperties": false, "properties": { "connection_ref": { "pattern": "^[A-Za-z0-9_.-]{1,128}$", "type": "string" }, "entitlement_ref": { "pattern": "^[A-Za-z0-9_-]{1,128}$", "type": "string" }, "environment": { "enum": [ "sandbox", "live" ], "type": "string" }, "error_code": { "anyOf": [ { "maxLength": 96, "type": "string" }, { "type": "null" } ] }, "event_id": { "format": "uuid", "type": "string" }, "payload_sha256": { "pattern": "^[0-9a-f]{64}$", "type": "string" }, "status": { "enum": [ "pending", "applied", "rejected", "manual_review" ], "type": "string" }, "version": { "minimum": 1, "type": "integer" } }, "required": [ "event_id", "connection_ref", "environment", "entitlement_ref", "version", "payload_sha256", "status", "error_code" ], "type": "object" }, "ExternalReceiptResponse": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/ExternalReceipt" }, "request_id": { "type": "string" } }, "required": [ "data" ], "type": "object" }, "ExternalSnapshot": { "additionalProperties": false, "properties": { "account_ref": { "pattern": "^[A-Za-z0-9_-]{1,128}$", "type": "string" }, "change_reason": { "enum": [ "purchase", "renewal", "upgrade", "refund", "reversal", "suspension", "resumption", "expiry", "reconciliation" ], "type": "string" }, "connection_ref": { "pattern": "^[A-Za-z0-9_.-]{1,128}$", "type": "string" }, "desired_state": { "enum": [ "active", "suspended", "expired", "revoked" ], "type": "string" }, "entitlement_ref": { "pattern": "^[A-Za-z0-9_-]{1,128}$", "type": "string" }, "environment": { "enum": [ "sandbox", "live" ], "type": "string" }, "event_id": { "format": "uuid", "type": "string" }, "launch_plan_version_id": { "format": "uuid", "type": "string" }, "launch_product_id": { "format": "uuid", "type": "string" }, "plan_ref": { "pattern": "^[A-Za-z0-9_.-]{1,128}$", "type": "string" }, "product_ref": { "pattern": "^[A-Za-z0-9_.-]{1,128}$", "type": "string" }, "schema": { "const": "launch-external-licensing-v1", "type": "string" }, "type": { "const": "entitlement.snapshot", "type": "string" }, "valid_from": { "format": "date-time", "type": "string" }, "valid_until": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "version": { "minimum": 1, "type": "integer" } }, "required": [ "schema", "event_id", "connection_ref", "environment", "type", "change_reason", "account_ref", "entitlement_ref", "launch_product_id", "launch_plan_version_id", "product_ref", "plan_ref", "version", "desired_state", "valid_from", "valid_until" ], "type": "object" }, "HealthResponse": { "properties": { "data": { "properties": { "status": { "const": "ok" } }, "required": [ "status" ], "type": "object" }, "request_id": { "$ref": "#/components/schemas/RequestID" } }, "required": [ "data", "request_id" ], "type": "object" }, "IntegrationBundle": { "properties": { "checked_at": { "format": "date-time", "type": "string" }, "checks": { "items": { "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "status": { "type": "string" } }, "required": [ "code", "status", "message" ], "type": "object" }, "type": "array" }, "config": { "additionalProperties": false, "properties": { "environment": { "enum": [ "sandbox", "live" ], "type": "string" }, "launch_product_id": { "format": "uuid", "type": "string" }, "licentivo_product_id": { "anyOf": [ { "format": "uuid", "type": "string" }, { "const": "" } ], "description": "Nur leer, wenn eine fehlgeschlagene Prüfung keine Zuordnung auflösen konnte." }, "merchant_origin": { "format": "uri", "type": "string" }, "schema_version": { "const": 1, "type": "integer" } }, "required": [ "schema_version", "merchant_origin", "launch_product_id", "licentivo_product_id", "environment" ], "type": "object" }, "example_path": { "type": "string" }, "language": { "enum": [ "go", "python", "csharp", "java", "javascript", "rust", "ruby", "c", "cpp", "web" ], "type": "string" }, "product_config": { "$ref": "#/components/schemas/PublicProductConfig" }, "ready": { "type": "boolean" } }, "required": [ "ready", "config", "checks", "language", "example_path", "checked_at" ], "type": "object" }, "LaunchIdentity": { "additionalProperties": false, "properties": { "audience": { "type": "string" }, "environment": { "enum": [ "sandbox", "live" ], "type": "string" }, "expires_at": { "format": "date-time", "type": "string" }, "identity_token": { "description": "Kurzlebige Identitäts-Assertion, höchstens 120 Sekunden; niemals eine Laufzeitberechtigung.", "type": "string" }, "launch_connection_id": { "format": "uuid", "type": "string" }, "licentivo_product_id": { "format": "uuid", "type": "string" }, "product_id": { "format": "uuid", "type": "string" }, "token_type": { "type": "string" } }, "required": [ "identity_token", "token_type", "product_id", "licentivo_product_id", "launch_connection_id", "environment", "audience", "expires_at" ], "type": "object" }, "LicensingConnections": { "additionalProperties": false, "properties": { "bindings": { "items": { "$ref": "#/components/schemas/ProductLicensingBinding" }, "type": "array" }, "connections": { "items": { "$ref": "#/components/schemas/ExternalConnection" }, "type": "array" }, "default_provider": { "description": "Der eine aktive Lizenzanbieter für alle Produkte und beide Umgebungen.", "enum": [ "licentivo", "custom_http" ], "type": "string" }, "mappings": { "items": { "$ref": "#/components/schemas/ExternalMapping" }, "type": "array" } }, "required": [ "connections", "bindings", "mappings", "default_provider" ], "type": "object" }, "LicensingConnectionsResponse": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/LicensingConnections" }, "request_id": { "type": "string" } }, "required": [ "data" ], "type": "object" }, "LicensingProviderInput": { "additionalProperties": false, "properties": { "provider": { "enum": [ "licentivo", "custom_http" ], "type": "string" } }, "required": [ "provider" ], "type": "object" }, "LicensingSaved": { "additionalProperties": false, "properties": { "saved": { "const": true, "type": "boolean" } }, "required": [ "saved" ], "type": "object" }, "LicensingSavedResponse": { "additionalProperties": false, "properties": { "data": { "$ref": "#/components/schemas/LicensingSaved" }, "request_id": { "type": "string" } }, "required": [ "data" ], "type": "object" }, "LicentivoConnectionInput": { "additionalProperties": false, "properties": { "api_key": { "description": "Für die erste Verbindung erforderlich. Auslassen oder leer lassen, um den gespeicherten serverseitigen Schlüssel zu behalten.", "type": "string", "writeOnly": true }, "webhook_secret": { "description": "Optionales Geheimnis von 32–256 Bytes. Auslassen oder leer lassen, um das gespeicherte Geheimnis zu behalten.", "type": "string", "writeOnly": true } }, "type": "object" }, "Order": { "properties": { "action": { "type": "string" }, "amount_minor": { "type": "integer" }, "created_at": { "format": "date-time", "type": "string" }, "currency": { "type": "string" }, "environment": { "enum": [ "sandbox", "live" ], "type": "string" }, "id": { "format": "uuid", "type": "string" }, "paid_at": { "format": "date-time", "type": [ "string", "null" ] }, "plan_name": { "type": "string" }, "plan_version": { "type": "integer" }, "plan_version_id": { "format": "uuid", "type": "string" }, "product_id": { "format": "uuid", "type": "string" }, "product_name": { "type": "string" }, "product_slug": { "type": "string" }, "purchase_periods": { "type": "integer" }, "status": { "type": "string" } }, "required": [ "id", "product_id", "product_name", "product_slug", "plan_version_id", "plan_name", "plan_version", "action", "status", "currency", "amount_minor", "purchase_periods", "created_at", "paid_at", "environment" ], "type": "object" }, "ProductLicensingBinding": { "additionalProperties": false, "properties": { "connection_id": { "anyOf": [ { "format": "uuid", "type": "string" }, { "type": "null" } ] }, "environment": { "enum": [ "sandbox", "live" ], "type": "string" }, "product_id": { "format": "uuid", "type": "string" }, "provider": { "enum": [ "licentivo", "custom_http" ], "type": "string" } }, "required": [ "product_id", "environment", "provider", "connection_id" ], "type": "object" }, "ProductLicensingInput": { "additionalProperties": false, "properties": { "connection_id": { "description": "UUID der externen Verbindung; für custom_http erforderlich.", "type": "string" }, "environment": { "enum": [ "sandbox", "live" ], "type": "string" }, "mappings": { "items": { "$ref": "#/components/schemas/ExternalMappingInput" }, "type": "array" }, "provider": { "description": "Muss dem instanzweit aktiven Lizenzanbieter entsprechen. Diesen zuerst mit PUT /api/v1/admin/licensing/provider konfigurieren.", "enum": [ "licentivo", "custom_http" ], "type": "string" } }, "required": [ "provider", "environment" ], "type": "object" }, "PublicLaunchConfig": { "additionalProperties": false, "properties": { "environment": { "enum": [ "sandbox", "live" ], "type": "string" }, "launch_product_id": { "format": "uuid", "type": "string" }, "licentivo_product_id": { "format": "uuid", "type": "string" }, "merchant_origin": { "format": "uri", "type": "string" }, "schema_version": { "const": 1, "type": "integer" } }, "required": [ "schema_version", "merchant_origin", "launch_product_id", "licentivo_product_id", "environment" ], "type": "object" }, "PublicProductConfig": { "additionalProperties": false, "description": "Bereinigte öffentliche Konfiguration. Die Herkunft des Signaturschlüssels muss vom Händler überprüft werden.", "properties": { "app_version": { "type": "string" }, "base_url": { "format": "uri", "type": "string" }, "product_id": { "format": "uuid", "type": "string" }, "trusted_keys": { "additionalProperties": { "pattern": "^[A-Za-z0-9_-]{43}$", "type": "string" }, "maxProperties": 32, "minProperties": 1, "propertyNames": { "description": "Schlüsselkennungen sind 1–128 UTF-8-Bytes lang.", "minLength": 1, "type": "string", "x-maxBytes": 128 }, "type": "object" } }, "required": [ "product_id", "trusted_keys", "base_url" ], "type": "object" }, "PublicProductImport": { "additionalProperties": false, "description": "Öffentliche Launch-Produktkonfiguration, aus offizieller Produkt-ID und öffentlichen Signaturschlüsseln befüllt. Legacy-JSON mit leerem license_key/cache_path und false für allow_http wird akzeptiert und bereinigt. Befüllte Geheimnisse und unbekannte Felder werden abgelehnt.", "properties": { "allow_http": { "const": false }, "app_version": { "description": "Höchstens 80 UTF-8-Bytes.", "type": "string", "x-maxBytes": 80 }, "base_url": { "format": "uri", "type": "string" }, "cache_path": { "const": "" }, "device_name": { "maxLength": 128, "type": "string" }, "license_key": { "const": "" }, "product_id": { "format": "uuid", "type": "string" }, "trusted_keys": { "additionalProperties": { "pattern": "^[A-Za-z0-9_-]{43}$", "type": "string" }, "maxProperties": 32, "minProperties": 1, "propertyNames": { "description": "Schlüsselkennungen sind 1–128 UTF-8-Bytes lang.", "minLength": 1, "type": "string", "x-maxBytes": 128 }, "type": "object" } }, "required": [ "product_id", "trusted_keys" ], "type": "object" }, "ReadinessResponse": { "properties": { "data": { "properties": { "code": { "enum": [ "DATABASE_NOT_CONFIGURED", "DATABASE_UNAVAILABLE", "DATABASE_SCHEMA_NOT_READY" ] }, "status": { "enum": [ "ready", "not_ready" ] } }, "required": [ "status" ], "type": "object" }, "request_id": { "$ref": "#/components/schemas/RequestID" } }, "required": [ "data", "request_id" ], "type": "object" }, "RequestID": { "description": "Auch im X-Request-ID-Antwortheader zurückgegeben", "pattern": "^[a-f0-9]{32}$", "type": "string" }, "SessionGrant": { "properties": { "access_token": { "description": "Nur bei Desktop-Anmeldung zurückgegeben. Als Geheimnis behandeln; niemals in URLs oder Protokolle aufnehmen.", "type": "string", "x-sensitive": true }, "expires_at": { "format": "date-time", "type": "string" }, "kind": { "enum": [ "website", "desktop" ], "type": "string" }, "user": { "$ref": "#/components/schemas/User" } }, "required": [ "user", "kind", "expires_at" ], "type": "object" }, "SessionView": { "properties": { "created_at": { "format": "date-time", "type": "string" }, "current": { "type": "boolean" }, "expires_at": { "format": "date-time", "type": "string" }, "id": { "format": "uuid", "type": "string" }, "kind": { "enum": [ "website", "desktop" ], "type": "string" } }, "required": [ "id", "kind", "created_at", "expires_at", "current" ], "type": "object" }, "User": { "properties": { "email": { "format": "email", "type": "string" }, "full_access": { "type": "boolean" }, "id": { "format": "uuid", "type": "string" }, "password_change_required": { "type": "boolean" }, "role": { "enum": [ "customer", "admin", "operations", "support" ], "type": "string" }, "verified": { "type": "boolean" } }, "required": [ "id", "email", "verified", "role", "full_access", "password_change_required" ], "type": "object" } }, "securitySchemes": { "desktopBearer": { "description": "Opake Desktop-Sitzung aus auth/login mit kind=desktop.", "scheme": "bearer", "type": "http" }, "websiteCookie": { "description": "Browser-Sitzung. Änderungen erfordern außerdem passenden Origin und X-CSRF-Token aus launch_csrf.", "in": "cookie", "name": "launch_session", "type": "apiKey" } } }, "info": { "description": "System-, Konto-, Desktop-Lizenzierungs-, Integrationsassistent- und grundlegende Kauf-APIs. Dies ist nicht die vollständige Personaladministrations-/Zahlungswebhook-API. Laufzeitzugriff muss weiterhin das offizielle Licentivo SDK durchlaufen. E-Mail-Verifikation ist nur erforderlich, wenn der Händler sie aktiviert. Benutzerdefinierte Lizenzverbindungen und Kundenbereitstellung sind ebenfalls dokumentiert. Externe Empfängerendpunkte sind separat in external-licensing-openapi.json angegeben.", "license": { "identifier": "MIT", "name": "MIT" }, "title": "Licentivo Launch Integration API", "version": "0.3.4-beta", "x-document-language": "de" }, "openapi": "3.1.0", "paths": { "/api/v1/admin/connections/licentivo": { "post": { "operationId": "configureLicentivoConnection", "parameters": [ { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LicentivoConnectionInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "additionalProperties": true, "description": "Verbindungsidentität, verifizierte Fähigkeiten und Katalog. Gespeicherte Geheimnisse werden niemals zurückgegeben.", "type": "object" }, "request_id": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Erfolgreiche Antwort" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Ungültige Konfiguration/Eingabe" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Authentifizierung erforderlich" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Administrator erforderlich, ungültiges CSRF oder verbotener Umfang" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Keine eigene Ressource" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unveränderliche Zuordnung, Migration erforderlich oder Kauf nicht bereit" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Ratenbegrenzt" }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Speicher/externer Dienst nicht verfügbar" } }, "security": [ { "websiteCookie": [] } ], "summary": "Serverseitige Licentivo-Managementverbindung validieren und speichern", "tags": [ "Licentivo connection" ] } }, "/api/v1/admin/identity-notifications/{id}/retry": { "post": { "operationId": "retryIdentityNotification", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "reason": { "maxLength": 500, "minLength": 2, "type": "string" } }, "required": [ "reason" ], "type": "object" } } }, "required": true }, "responses": { "200": { "description": "Wiederholung der ursprünglichen Benachrichtigung eingeplant" }, "403": { "description": "Administratorberechtigung erforderlich" }, "409": { "description": "Benachrichtigung abgeschlossen oder in Bearbeitung" } }, "security": [ { "websiteCookie": [] } ], "summary": "Kontosicherheits-Widerrufsbenachrichtigung erneut versuchen (Administrator)" } }, "/api/v1/admin/integration/check": { "post": { "description": "Erfordert die Administratorrolle. Website-Aufrufer müssen Origin und X-CSRF-Token übermitteln. ready=false meldet unvollständige Konfiguration; es werden keine geheimen Felder zurückgegeben. licentivo_product_id kann in einem unvollständigen Bericht leer sein.", "operationId": "checkApplicationIntegration", "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "environment": { "enum": [ "sandbox", "live" ], "type": "string" }, "language": { "enum": [ "go", "python", "csharp", "java", "javascript", "rust", "ruby", "c", "cpp", "web" ], "type": "string" }, "product_id": { "format": "uuid", "type": "string" } }, "required": [ "product_id", "environment", "language" ], "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/IntegrationBundle" }, "request_id": { "$ref": "#/components/schemas/RequestID" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Erfolgreiche Antwort." }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Ungültige Felder, Produkt-ID oder Umgebung." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "LOGIN_FAILED (login) oder AUTH_REQUIRED (abgelaufene/widerrufene Sitzung). Abgelehnte Sitzungen löschen; nach ausdrücklicher Ablehnung niemals zurückfallen." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Verboten, E-Mail-Verifikation erforderlich, erstmalige Passwortänderung erforderlich oder ausdrückliche Ablehnung der Berechtigung." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "RATE_LIMITED; nicht in einer engen Schleife wiederholen.", "headers": { "Retry-After": { "description": "Wartezeit in Sekunden vor dem nächsten Versuch. Diesen Wert einhalten und die Gesamtzahl der Wiederholungen begrenzen.", "schema": { "minimum": 0, "type": "integer" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Vorübergehender Dienst- oder Datenbankfehler. Offline-Zugriff ist nur durch eine gültige signierte Berechtigung des offiziellen SDK erlaubt." } }, "security": [ { "desktopBearer": [] }, { "websiteCookie": [] } ], "summary": "Ausgewählte Softwarezuordnung und öffentliche Signaturschlüssel automatisch für direkte SDK-Initialisierung lesen", "tags": [ "Application integration" ] } }, "/api/v1/admin/integration/context": { "get": { "description": "Erfordert die Administratorrolle. Website-Aufrufer müssen Origin und X-CSRF-Token übermitteln. ready=false meldet unvollständige Konfiguration; es werden keine geheimen Felder zurückgegeben. licentivo_product_id kann in einem unvollständigen Bericht leer sein.", "operationId": "getIntegrationContext", "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "additionalProperties": false, "properties": { "licensing_origin": { "type": "string" }, "merchant_origin": { "type": "string" } }, "required": [ "merchant_origin", "licensing_origin" ], "type": "object" }, "request_id": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Öffentlicher Bereitstellungskontext; keine privaten Starteinstellungen" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Ungültige Felder, Produkt-ID oder Umgebung." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "LOGIN_FAILED (login) oder AUTH_REQUIRED (abgelaufene/widerrufene Sitzung). Abgelehnte Sitzungen löschen; nach ausdrücklicher Ablehnung niemals zurückfallen." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Verboten, E-Mail-Verifikation erforderlich, erstmalige Passwortänderung erforderlich oder ausdrückliche Ablehnung der Berechtigung." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "RATE_LIMITED; nicht in einer engen Schleife wiederholen.", "headers": { "Retry-After": { "description": "Wartezeit in Sekunden vor dem nächsten Versuch. Diesen Wert einhalten und die Gesamtzahl der Wiederholungen begrenzen.", "schema": { "minimum": 0, "type": "integer" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Vorübergehender Dienst- oder Datenbankfehler. Offline-Zugriff ist nur durch eine gültige signierte Berechtigung des offiziellen SDK erlaubt." } }, "security": [ { "desktopBearer": [] }, { "websiteCookie": [] } ], "summary": "Konfigurierten Händler-Origin und festen Lizenzierungs-Origin lesen", "tags": [ "Application integration" ] } }, "/api/v1/admin/licensing/connections": { "get": { "operationId": "listLicensingChoices", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LicensingConnectionsResponse" } } }, "description": "Erfolgreiche Antwort" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Ungültige Konfiguration/Eingabe" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Authentifizierung erforderlich" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Administrator erforderlich, ungültiges CSRF oder verbotener Umfang" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Keine eigene Ressource" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unveränderliche Zuordnung, Migration erforderlich oder Kauf nicht bereit" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Ratenbegrenzt" }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Speicher/externer Dienst nicht verfügbar" } }, "security": [ { "desktopBearer": [] }, { "websiteCookie": [] } ], "summary": "Externe Verbindungen, Produktbindungen und Zuordnungen auflisten; Licentivo-Einstellungen behalten ihre bestehende API", "tags": [ "Custom licensing" ] }, "post": { "operationId": "createExternalLicensingConnection", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExternalConnectionInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExternalConnectionResponse" } } }, "description": "Erfolgreiche Antwort" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Ungültige Konfiguration/Eingabe" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Authentifizierung erforderlich" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Administrator erforderlich, ungültiges CSRF oder verbotener Umfang" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Keine eigene Ressource" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unveränderliche Zuordnung, Migration erforderlich oder Kauf nicht bereit" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Ratenbegrenzt" }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Speicher/externer Dienst nicht verfügbar" } }, "security": [ { "desktopBearer": [] }, { "websiteCookie": [] } ], "summary": "Benutzerdefinierte HTTP-Lizenzverbindung prüfen und speichern", "tags": [ "Custom licensing" ] } }, "/api/v1/admin/licensing/connections/{id}": { "put": { "operationId": "updateExternalLicensingConnection", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExternalConnectionInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExternalConnectionResponse" } } }, "description": "Erfolgreiche Antwort" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Ungültige Konfiguration/Eingabe" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Authentifizierung erforderlich" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Administrator erforderlich, ungültiges CSRF oder verbotener Umfang" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Keine eigene Ressource" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unveränderliche Zuordnung, Migration erforderlich oder Kauf nicht bereit" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Ratenbegrenzt" }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Speicher/externer Dienst nicht verfügbar" } }, "security": [ { "desktopBearer": [] }, { "websiteCookie": [] } ], "summary": "Metadaten/Signaturschlüssel bearbeiten; Ziel, Umgebung und Netzwerkrichtlinie sind unveränderlich", "tags": [ "Custom licensing" ] } }, "/api/v1/admin/licensing/connections/{id}/check": { "post": { "operationId": "checkExternalLicensingConnection", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExternalConnectionResponse" } } }, "description": "Erfolgreiche Antwort" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Ungültige Konfiguration/Eingabe" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Authentifizierung erforderlich" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Administrator erforderlich, ungültiges CSRF oder verbotener Umfang" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Keine eigene Ressource" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unveränderliche Zuordnung, Migration erforderlich oder Kauf nicht bereit" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Ratenbegrenzt" }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Speicher/externer Dienst nicht verfügbar" } }, "security": [ { "desktopBearer": [] }, { "websiteCookie": [] } ], "summary": "Fähigkeiten aktualisieren; last_check_error unterscheidet eine fehlgeschlagene Prüfung in der 200-Antwort", "tags": [ "Custom licensing" ] } }, "/api/v1/admin/licensing/provider": { "put": { "operationId": "selectLicensingProvider", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LicensingProviderInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LicensingSavedResponse" } } }, "description": "Erfolgreiche Antwort" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Ungültige Konfiguration/Eingabe" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Authentifizierung erforderlich" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Administrator erforderlich, ungültiges CSRF oder verbotener Umfang" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Keine eigene Ressource" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unveränderliche Zuordnung, Migration erforderlich oder Kauf nicht bereit" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Ratenbegrenzt" }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Speicher/externer Dienst nicht verfügbar" } }, "security": [ { "desktopBearer": [] }, { "websiteCookie": [] } ], "summary": "Einen Lizenzanbieter für die gesamte Instanz aktivieren; bei Bestellungen eines anderen Anbieters erfordert der Wechsel eine Migration", "tags": [ "Custom licensing" ] } }, "/api/v1/admin/products/{id}/licensing": { "put": { "operationId": "configureProductLicensing", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductLicensingInput" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LicensingSavedResponse" } } }, "description": "Erfolgreiche Antwort" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Ungültige Konfiguration/Eingabe" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Authentifizierung erforderlich" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Administrator erforderlich, ungültiges CSRF oder verbotener Umfang" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Keine eigene Ressource" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unveränderliche Zuordnung, Migration erforderlich oder Kauf nicht bereit" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Ratenbegrenzt" }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Speicher/externer Dienst nicht verfügbar" } }, "security": [ { "desktopBearer": [] }, { "websiteCookie": [] } ], "summary": "Produktverbindung und Planzuordnungen für eine Umgebung mit dem aktiven Lizenzanbieter konfigurieren", "tags": [ "Custom licensing" ] } }, "/api/v1/admin/refunds/{id}/reconcile": { "post": { "description": "Der Administrator prüft die ursprüngliche Erstattung und setzt dieselbe Operation fort, nachdem ursprüngliche Transaktion, Betrag und Währung anhand des Kanalbelegs verifiziert wurden. Ohne Beleg wird die ursprüngliche idempotente Anfrage nur innerhalb von 23 Stunden nach dem ursprünglichen Stripe/PayPal-Genehmigungszeitpunkt wiederholt; danach ist die Erstattungskennung des ursprünglichen Kanals erforderlich. Die Operation wird auditiert und erstellt keine neue Erstattungsoperationsnummer.", "operationId": "reconcileRefund", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "properties": { "external_refund_id": { "maxLength": 128, "type": "string" }, "reason": { "maxLength": 500, "minLength": 2, "type": "string" } }, "required": [ "reason" ], "type": "object" } } }, "required": true }, "responses": { "200": { "description": "Ursprünglicher Auftrag erneut in die Warteschlange gestellt" }, "403": { "description": "Administratorberechtigung und gültige CSRF-Zugangsdaten erforderlich" }, "409": { "description": "Statuskonflikt, nicht übereinstimmender Beleg oder Erstattungskennung des ursprünglichen Kanals erforderlich" }, "503": { "description": "Abfrage des ursprünglichen Kanals vorübergehend nicht verfügbar" } }, "security": [ { "websiteCookie": [] } ], "summary": "Ursprünglichen Erstattungsauftrag prüfen und wiederherstellen" } }, "/api/v1/auth/complete-email": { "post": { "operationId": "completeAccountEmail", "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "password": { "type": "string", "writeOnly": true }, "token": { "type": "string", "writeOnly": true } }, "required": [ "token" ], "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "properties": { "completed": { "type": "boolean" } }, "required": [ "completed" ], "type": "object" }, "request_id": { "$ref": "#/components/schemas/RequestID" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Erfolgreiche Antwort." }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Ungültige Felder, Produkt-ID oder Umgebung." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "LOGIN_FAILED (login) oder AUTH_REQUIRED (abgelaufene/widerrufene Sitzung). Abgelehnte Sitzungen löschen; nach ausdrücklicher Ablehnung niemals zurückfallen." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Verboten, E-Mail-Verifikation erforderlich, erstmalige Passwortänderung erforderlich oder ausdrückliche Ablehnung der Berechtigung." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "RATE_LIMITED; nicht in einer engen Schleife wiederholen.", "headers": { "Retry-After": { "description": "Wartezeit in Sekunden vor dem nächsten Versuch. Diesen Wert einhalten und die Gesamtzahl der Wiederholungen begrenzen.", "schema": { "minimum": 0, "type": "integer" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Vorübergehender Dienst- oder Datenbankfehler. Offline-Zugriff ist nur durch eine gültige signierte Berechtigung des offiziellen SDK erlaubt." } }, "security": [], "summary": "Einmal verwendbares E-Mail-Zugangsmittel abschließen", "tags": [ "Application integration" ] } }, "/api/v1/auth/email": { "post": { "operationId": "requestAccountEmail", "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "email": { "format": "email", "type": "string" }, "kind": { "enum": [ "verify", "reset" ], "type": "string" } }, "required": [ "email", "kind" ], "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "properties": { "accepted": { "type": "boolean" } }, "required": [ "accepted" ], "type": "object" }, "request_id": { "$ref": "#/components/schemas/RequestID" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Erfolgreiche Antwort." }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Ungültige Felder, Produkt-ID oder Umgebung." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "LOGIN_FAILED (login) oder AUTH_REQUIRED (abgelaufene/widerrufene Sitzung). Abgelehnte Sitzungen löschen; nach ausdrücklicher Ablehnung niemals zurückfallen." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Verboten, E-Mail-Verifikation erforderlich, erstmalige Passwortänderung erforderlich oder ausdrückliche Ablehnung der Berechtigung." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "RATE_LIMITED; nicht in einer engen Schleife wiederholen.", "headers": { "Retry-After": { "description": "Wartezeit in Sekunden vor dem nächsten Versuch. Diesen Wert einhalten und die Gesamtzahl der Wiederholungen begrenzen.", "schema": { "minimum": 0, "type": "integer" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Vorübergehender Dienst- oder Datenbankfehler. Offline-Zugriff ist nur durch eine gültige signierte Berechtigung des offiziellen SDK erlaubt." } }, "security": [], "summary": "Verifikations- oder Passwortwiederherstellungs-E-Mail anfordern", "tags": [ "Application integration" ] } }, "/api/v1/auth/identity-keys": { "get": { "operationId": "launchIdentityPublicKeys", "responses": { "200": { "description": "Öffentliche Ed25519-Schlüssel; niemals privates Signaturmaterial" } }, "summary": "Öffentliche angeheftete Signaturschlüssel für Launch-Kontoidentität" } }, "/api/v1/auth/login": { "post": { "description": "Für Anwendungen kind=desktop setzen und den Browser-Origin-Header auslassen. Website-Anmeldung setzt Cookies und lässt access_token aus.", "operationId": "login", "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "email": { "format": "email", "type": "string" }, "kind": { "default": "website", "enum": [ "desktop", "website" ], "type": "string" }, "password": { "type": "string", "writeOnly": true } }, "required": [ "email", "password" ], "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/SessionGrant" }, "request_id": { "$ref": "#/components/schemas/RequestID" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Erfolgreiche Antwort." }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Ungültige Felder, Produkt-ID oder Umgebung." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "LOGIN_FAILED (login) oder AUTH_REQUIRED (abgelaufene/widerrufene Sitzung). Abgelehnte Sitzungen löschen; nach ausdrücklicher Ablehnung niemals zurückfallen." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Verboten, E-Mail-Verifikation erforderlich, erstmalige Passwortänderung erforderlich oder ausdrückliche Ablehnung der Berechtigung." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "RATE_LIMITED; nicht in einer engen Schleife wiederholen.", "headers": { "Retry-After": { "description": "Wartezeit in Sekunden vor dem nächsten Versuch. Diesen Wert einhalten und die Gesamtzahl der Wiederholungen begrenzen.", "schema": { "minimum": 0, "type": "integer" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Vorübergehender Dienst- oder Datenbankfehler. Offline-Zugriff ist nur durch eine gültige signierte Berechtigung des offiziellen SDK erlaubt." } }, "security": [], "summary": "Auf Website oder Desktop anmelden", "tags": [ "Application integration" ] } }, "/api/v1/auth/logout": { "post": { "operationId": "logout", "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": {}, "required": [], "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "properties": { "completed": { "type": "boolean" } }, "required": [ "completed" ], "type": "object" }, "request_id": { "$ref": "#/components/schemas/RequestID" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Erfolgreiche Antwort." }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Ungültige Felder, Produkt-ID oder Umgebung." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "LOGIN_FAILED (login) oder AUTH_REQUIRED (abgelaufene/widerrufene Sitzung). Abgelehnte Sitzungen löschen; nach ausdrücklicher Ablehnung niemals zurückfallen." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Verboten, E-Mail-Verifikation erforderlich, erstmalige Passwortänderung erforderlich oder ausdrückliche Ablehnung der Berechtigung." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "RATE_LIMITED; nicht in einer engen Schleife wiederholen.", "headers": { "Retry-After": { "description": "Wartezeit in Sekunden vor dem nächsten Versuch. Diesen Wert einhalten und die Gesamtzahl der Wiederholungen begrenzen.", "schema": { "minimum": 0, "type": "integer" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Vorübergehender Dienst- oder Datenbankfehler. Offline-Zugriff ist nur durch eine gültige signierte Berechtigung des offiziellen SDK erlaubt." } }, "security": [ { "desktopBearer": [] }, { "websiteCookie": [] } ], "summary": "Aktuelle Sitzung widerrufen; SDK-Schließen, lokale Bereinigung und Gerätefreigabe bleiben getrennte Aktionen", "tags": [ "Application integration" ] } }, "/api/v1/auth/register": { "post": { "operationId": "registerCustomer", "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "email": { "format": "email", "type": "string" }, "password": { "description": "12–128 UTF-8-Bytes (der Server zählt Bytes, keine Unicode-Zeichen).", "type": "string", "writeOnly": true, "x-maxBytes": 128, "x-minBytes": 12 } }, "required": [ "email", "password" ], "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "properties": { "accepted": { "type": "boolean" } }, "required": [ "accepted" ], "type": "object" }, "request_id": { "$ref": "#/components/schemas/RequestID" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Erfolgreiche Antwort." }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Ungültige Felder, Produkt-ID oder Umgebung." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "LOGIN_FAILED (login) oder AUTH_REQUIRED (abgelaufene/widerrufene Sitzung). Abgelehnte Sitzungen löschen; nach ausdrücklicher Ablehnung niemals zurückfallen." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Verboten, E-Mail-Verifikation erforderlich, erstmalige Passwortänderung erforderlich oder ausdrückliche Ablehnung der Berechtigung." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "RATE_LIMITED; nicht in einer engen Schleife wiederholen.", "headers": { "Retry-After": { "description": "Wartezeit in Sekunden vor dem nächsten Versuch. Diesen Wert einhalten und die Gesamtzahl der Wiederholungen begrenzen.", "schema": { "minimum": 0, "type": "integer" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Vorübergehender Dienst- oder Datenbankfehler. Offline-Zugriff ist nur durch eine gültige signierte Berechtigung des offiziellen SDK erlaubt." } }, "security": [], "summary": "Kunden registrieren; Verifikation folgt den E-Mail-Einstellungen des Händlers", "tags": [ "Application integration" ] } }, "/api/v1/licensing/documentation": { "get": { "operationId": "readExternalLicensingGuide", "responses": { "200": { "content": { "text/plain": { "schema": { "type": "string" } } }, "description": "Öffentliches Dokument" } }, "security": [], "summary": "Öffentliche Dokumentation zur externen Lizenzierung" } }, "/api/v1/licensing/protocol": { "get": { "operationId": "readExternalLicensingProtocol", "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "Öffentliches Dokument" } }, "security": [], "summary": "Öffentliche Dokumentation zur externen Lizenzierung" } }, "/api/v1/me": { "get": { "operationId": "currentUser", "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "properties": { "session_id": { "format": "uuid", "type": "string" }, "user": { "$ref": "#/components/schemas/User" } }, "required": [ "user", "session_id" ], "type": "object" }, "request_id": { "$ref": "#/components/schemas/RequestID" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Erfolgreiche Antwort." }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Ungültige Felder, Produkt-ID oder Umgebung." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "LOGIN_FAILED (login) oder AUTH_REQUIRED (abgelaufene/widerrufene Sitzung). Abgelehnte Sitzungen löschen; nach ausdrücklicher Ablehnung niemals zurückfallen." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Verboten, E-Mail-Verifikation erforderlich, erstmalige Passwortänderung erforderlich oder ausdrückliche Ablehnung der Berechtigung." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "RATE_LIMITED; nicht in einer engen Schleife wiederholen.", "headers": { "Retry-After": { "description": "Wartezeit in Sekunden vor dem nächsten Versuch. Diesen Wert einhalten und die Gesamtzahl der Wiederholungen begrenzen.", "schema": { "minimum": 0, "type": "integer" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Vorübergehender Dienst- oder Datenbankfehler. Offline-Zugriff ist nur durch eine gültige signierte Berechtigung des offiziellen SDK erlaubt." } }, "security": [ { "desktopBearer": [] }, { "websiteCookie": [] } ], "summary": "Authentifiziertes Konto lesen", "tags": [ "Application integration" ] } }, "/api/v1/me/orders": { "get": { "operationId": "listOrders", "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "items": { "$ref": "#/components/schemas/Order" }, "type": "array" }, "request_id": { "$ref": "#/components/schemas/RequestID" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Erfolgreiche Antwort." }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Ungültige Felder, Produkt-ID oder Umgebung." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "LOGIN_FAILED (login) oder AUTH_REQUIRED (abgelaufene/widerrufene Sitzung). Abgelehnte Sitzungen löschen; nach ausdrücklicher Ablehnung niemals zurückfallen." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Verboten, E-Mail-Verifikation erforderlich, erstmalige Passwortänderung erforderlich oder ausdrückliche Ablehnung der Berechtigung." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "RATE_LIMITED; nicht in einer engen Schleife wiederholen.", "headers": { "Retry-After": { "description": "Wartezeit in Sekunden vor dem nächsten Versuch. Diesen Wert einhalten und die Gesamtzahl der Wiederholungen begrenzen.", "schema": { "minimum": 0, "type": "integer" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Vorübergehender Dienst- oder Datenbankfehler. Offline-Zugriff ist nur durch eine gültige signierte Berechtigung des offiziellen SDK erlaubt." } }, "security": [ { "desktopBearer": [] }, { "websiteCookie": [] } ], "summary": "Bestellungen des aktuellen Kunden auflisten", "tags": [ "Application integration" ] } }, "/api/v1/me/products/{id}/delivery": { "get": { "operationId": "readOwnedExternalDelivery", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } }, { "in": "query", "name": "environment", "required": true, "schema": { "enum": [ "sandbox", "live" ], "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExternalDeliveryResponse" } } }, "description": "Erfolgreiche Antwort" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Ungültige Konfiguration/Eingabe" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Authentifizierung erforderlich" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Administrator erforderlich, ungültiges CSRF oder verbotener Umfang" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Keine eigene Ressource" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Unveränderliche Zuordnung, Migration erforderlich oder Kauf nicht bereit" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Ratenbegrenzt" }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Speicher/externer Dienst nicht verfügbar" } }, "security": [ { "desktopBearer": [] }, { "websiteCookie": [] } ], "summary": "Aktuelle eigene externe Bereitstellung lesen; niemals eine Laufzeitautorisierungsentscheidung", "tags": [ "Custom licensing" ] } }, "/api/v1/me/sessions": { "get": { "operationId": "listSessions", "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "items": { "$ref": "#/components/schemas/SessionView" }, "type": "array" }, "request_id": { "$ref": "#/components/schemas/RequestID" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Erfolgreiche Antwort." }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Ungültige Felder, Produkt-ID oder Umgebung." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "LOGIN_FAILED (login) oder AUTH_REQUIRED (abgelaufene/widerrufene Sitzung). Abgelehnte Sitzungen löschen; nach ausdrücklicher Ablehnung niemals zurückfallen." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Verboten, E-Mail-Verifikation erforderlich, erstmalige Passwortänderung erforderlich oder ausdrückliche Ablehnung der Berechtigung." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "RATE_LIMITED; nicht in einer engen Schleife wiederholen.", "headers": { "Retry-After": { "description": "Wartezeit in Sekunden vor dem nächsten Versuch. Diesen Wert einhalten und die Gesamtzahl der Wiederholungen begrenzen.", "schema": { "minimum": 0, "type": "integer" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Vorübergehender Dienst- oder Datenbankfehler. Offline-Zugriff ist nur durch eine gültige signierte Berechtigung des offiziellen SDK erlaubt." } }, "security": [ { "desktopBearer": [] }, { "websiteCookie": [] } ], "summary": "Aktive Kontositzungen auflisten", "tags": [ "Application integration" ] } }, "/api/v1/me/sessions/{id}": { "delete": { "operationId": "revokeSession", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "properties": { "completed": { "type": "boolean" } }, "required": [ "completed" ], "type": "object" }, "request_id": { "$ref": "#/components/schemas/RequestID" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Erfolgreiche Antwort." }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Ungültige Felder, Produkt-ID oder Umgebung." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "LOGIN_FAILED (login) oder AUTH_REQUIRED (abgelaufene/widerrufene Sitzung). Abgelehnte Sitzungen löschen; nach ausdrücklicher Ablehnung niemals zurückfallen." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Verboten, E-Mail-Verifikation erforderlich, erstmalige Passwortänderung erforderlich oder ausdrückliche Ablehnung der Berechtigung." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "RATE_LIMITED; nicht in einer engen Schleife wiederholen.", "headers": { "Retry-After": { "description": "Wartezeit in Sekunden vor dem nächsten Versuch. Diesen Wert einhalten und die Gesamtzahl der Wiederholungen begrenzen.", "schema": { "minimum": 0, "type": "integer" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Vorübergehender Dienst- oder Datenbankfehler. Offline-Zugriff ist nur durch eine gültige signierte Berechtigung des offiziellen SDK erlaubt." } }, "security": [ { "desktopBearer": [] }, { "websiteCookie": [] } ], "summary": "Eigene Sitzung widerrufen", "tags": [ "Application integration" ] } }, "/api/v1/orders": { "post": { "description": "Preise werden auf dem Server berechnet. Verlängerung und Upgrade erfordern ein vom Server ausgestelltes Angebot. Dem gehosteten Checkout folgen; die Rückleitung ist kein Zahlungsnachweis.", "operationId": "createCheckout", "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "action": { "enum": [ "purchase", "renew", "upgrade" ], "type": "string" }, "environment": { "enum": [ "sandbox", "live" ], "type": "string" }, "idempotency_key": { "description": "Stabile Operationskennung, 16–80 UTF-8-Bytes. Für Wiederholungen derselben Operation denselben Schlüssel verwenden.", "type": "string", "x-maxBytes": 80, "x-minBytes": 16 }, "plan_version_id": { "format": "uuid", "type": "string" }, "product_id": { "format": "uuid", "type": "string" }, "provider": { "enum": [ "stripe", "paypal", "waffo", "paddle" ], "type": "string" }, "purchase_periods": { "minimum": 1, "type": "integer" }, "quote_token": { "type": "string", "writeOnly": true } }, "required": [ "product_id", "plan_version_id", "environment", "provider", "idempotency_key" ], "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/Checkout" }, "request_id": { "$ref": "#/components/schemas/RequestID" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Erfolgreiche Antwort." }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Ungültige Felder, Produkt-ID oder Umgebung." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "LOGIN_FAILED (login) oder AUTH_REQUIRED (abgelaufene/widerrufene Sitzung). Abgelehnte Sitzungen löschen; nach ausdrücklicher Ablehnung niemals zurückfallen." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Verboten, E-Mail-Verifikation erforderlich, erstmalige Passwortänderung erforderlich oder ausdrückliche Ablehnung der Berechtigung." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "RATE_LIMITED; nicht in einer engen Schleife wiederholen.", "headers": { "Retry-After": { "description": "Wartezeit in Sekunden vor dem nächsten Versuch. Diesen Wert einhalten und die Gesamtzahl der Wiederholungen begrenzen.", "schema": { "minimum": 0, "type": "integer" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Vorübergehender Dienst- oder Datenbankfehler. Offline-Zugriff ist nur durch eine gültige signierte Berechtigung des offiziellen SDK erlaubt." } }, "security": [ { "desktopBearer": [] }, { "websiteCookie": [] } ], "summary": "Eigenen Checkout mit stabilem Idempotenzschlüssel erstellen oder wiederherstellen", "tags": [ "Application integration" ] } }, "/api/v1/orders/{id}": { "get": { "operationId": "getOrder", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/Checkout" }, "request_id": { "$ref": "#/components/schemas/RequestID" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Erfolgreiche Antwort." }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Ungültige Felder, Produkt-ID oder Umgebung." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "LOGIN_FAILED (login) oder AUTH_REQUIRED (abgelaufene/widerrufene Sitzung). Abgelehnte Sitzungen löschen; nach ausdrücklicher Ablehnung niemals zurückfallen." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Verboten, E-Mail-Verifikation erforderlich, erstmalige Passwortänderung erforderlich oder ausdrückliche Ablehnung der Berechtigung." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "RATE_LIMITED; nicht in einer engen Schleife wiederholen.", "headers": { "Retry-After": { "description": "Wartezeit in Sekunden vor dem nächsten Versuch. Diesen Wert einhalten und die Gesamtzahl der Wiederholungen begrenzen.", "schema": { "minimum": 0, "type": "integer" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Vorübergehender Dienst- oder Datenbankfehler. Offline-Zugriff ist nur durch eine gültige signierte Berechtigung des offiziellen SDK erlaubt." } }, "security": [ { "desktopBearer": [] }, { "websiteCookie": [] } ], "summary": "Eigene Bestellung und Erfüllungsfortschritt lesen", "tags": [ "Application integration" ] } }, "/api/v1/orders/{id}/reconcile": { "post": { "operationId": "reconcileOrder", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": {}, "required": [], "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/Checkout" }, "request_id": { "$ref": "#/components/schemas/RequestID" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Erfolgreiche Antwort." }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Ungültige Felder, Produkt-ID oder Umgebung." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "LOGIN_FAILED (login) oder AUTH_REQUIRED (abgelaufene/widerrufene Sitzung). Abgelehnte Sitzungen löschen; nach ausdrücklicher Ablehnung niemals zurückfallen." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Verboten, E-Mail-Verifikation erforderlich, erstmalige Passwortänderung erforderlich oder ausdrückliche Ablehnung der Berechtigung." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "RATE_LIMITED; nicht in einer engen Schleife wiederholen.", "headers": { "Retry-After": { "description": "Wartezeit in Sekunden vor dem nächsten Versuch. Diesen Wert einhalten und die Gesamtzahl der Wiederholungen begrenzen.", "schema": { "minimum": 0, "type": "integer" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Vorübergehender Dienst- oder Datenbankfehler. Offline-Zugriff ist nur durch eine gültige signierte Berechtigung des offiziellen SDK erlaubt." } }, "security": [ { "desktopBearer": [] }, { "websiteCookie": [] } ], "summary": "Zahlungsanbieter für eine eigene Bestellung abfragen", "tags": [ "Application integration" ] } }, "/api/v1/software/products/{id}/credential": { "post": { "deprecated": true, "description": "Browser-Sitzungen können keine Lizenzschlüssel abrufen. Eine vom Client gewählte Benutzer-ID wird nicht akzeptiert. 403 ENTITLEMENT_PENDING enthält Retry-After: 3; Wiederholungen müssen begrenzt sein. EXPIRED/SUSPENDED erfordern eine Benutzeraktion. 404 ENTITLEMENT_NOT_PURCHASED bedeutet keine eigene Berechtigung.", "operationId": "softwareCredential", "parameters": [ { "description": "Launch-Produkt-ID, nicht die Licentivo-Produkt-ID.", "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "environment": { "enum": [ "sandbox", "live" ], "type": "string" } }, "required": [ "environment" ], "type": "object" } } }, "required": true }, "responses": { "410": { "description": "LICENSE_CREDENTIAL_REMOVED; es wird kein Lizenzschlüssel zurückgegeben" } }, "security": [ { "desktopBearer": [] } ], "summary": "Entfernt: Konto-SDKs müssen Identitätsaustausch verwenden", "tags": [ "Application integration" ] } }, "/api/v1/software/products/{id}/identity": { "post": { "operationId": "exchangeAccountIdentity", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "environment": { "enum": [ "sandbox", "live" ], "type": "string" } }, "required": [ "environment" ], "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/LaunchIdentity" } }, "type": "object" } } }, "description": "Nur Identitätskontext. Licentivo entscheidet über die Autorisierung." }, "401": { "description": "Kontositzung abgelehnt" }, "503": { "description": "Identitätsverbindung nicht verfügbar" } }, "security": [ { "desktopBearer": [] } ], "summary": "Kurzlebige Kontoidentitäts-Assertion für das offizielle SDK abrufen" } }, "/api/v1/software/products/{id}/status": { "get": { "description": "Dies sind Kauf-/Synchronisierungsinformationen, keine Laufzeitautorisierung.", "operationId": "softwareStatus", "parameters": [ { "description": "Launch-Produkt-ID, nicht die Licentivo-Produkt-ID.", "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } }, { "in": "query", "name": "environment", "required": false, "schema": { "default": "live", "enum": [ "sandbox", "live" ], "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "$ref": "#/components/schemas/EntitlementStatus" }, "request_id": { "$ref": "#/components/schemas/RequestID" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Erfolgreiche Antwort." }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Ungültige Felder, Produkt-ID oder Umgebung." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "LOGIN_FAILED (login) oder AUTH_REQUIRED (abgelaufene/widerrufene Sitzung). Abgelehnte Sitzungen löschen; nach ausdrücklicher Ablehnung niemals zurückfallen." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Verboten, E-Mail-Verifikation erforderlich, erstmalige Passwortänderung erforderlich oder ausdrückliche Ablehnung der Berechtigung." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "RATE_LIMITED; nicht in einer engen Schleife wiederholen.", "headers": { "Retry-After": { "description": "Wartezeit in Sekunden vor dem nächsten Versuch. Diesen Wert einhalten und die Gesamtzahl der Wiederholungen begrenzen.", "schema": { "minimum": 0, "type": "integer" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Vorübergehender Dienst- oder Datenbankfehler. Offline-Zugriff ist nur durch eine gültige signierte Berechtigung des offiziellen SDK erlaubt." } }, "security": [ { "desktopBearer": [] } ], "summary": "Handlungsrelevanten Status für den authentifizierten Kunden und das angeforderte Produkt lesen", "tags": [ "Application integration" ] } }, "/api/v1/system/status": { "get": { "operationId": "getSystemStatus", "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "properties": { "implemented": { "items": { "type": "string" }, "type": "array" }, "phase": { "const": "local-development" }, "product": { "const": "Licentivo Launch" }, "sales_enabled": { "const": false }, "version": { "type": "string" } }, "required": [ "product", "version", "phase", "sales_enabled", "implemented" ], "type": "object" }, "request_id": { "$ref": "#/components/schemas/RequestID" } }, "required": [ "data", "request_id" ], "type": "object" } } }, "description": "Aktuelle Entwicklungsphase und Implementierungsumfang" } }, "summary": "Version und Implementierungsumfang ohne Konfiguration oder Zugangsdaten offenlegen" } }, "/healthz": { "get": { "operationId": "getLiveness", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HealthResponse" } } }, "description": "Der HTTP-Prozess läuft" } }, "summary": "Prozessverfügbarkeit, unabhängig von Datenbankbereitschaft" } }, "/readyz": { "get": { "operationId": "getReadiness", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReadinessResponse" } } }, "description": "Die Datenbank ist bereit; dies bestätigt weder Zahlungs- noch Lizenzierungsabnahme" }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReadinessResponse" } } }, "description": "Die Datenbank ist nicht konfiguriert, nicht verfügbar oder erforderliche Tabellen fehlen" } }, "summary": "MySQL-Konnektivität und erforderliche GORM-Tabellen prüfen" } } }, "servers": [ { "description": "Durch Ihren Händler-Origin ersetzen; HTTP ist nur für Loopback-Sandbox-Entwicklung erlaubt.", "url": "https://shop.example.com" } ] }