{ "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": "Pour le SDK officiel uniquement ; ne jamais autoriser l'accès en inspectant cette valeur.", "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": "Seul le HTTP de loopback sandbox est autorisé.", "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": "Base64 standard de 32 à 128 octets aléatoires ; requis lors de la création, vide pour conserver la clé existante lors de la modification.", "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": "Contenu sensible ; maximum 4096 octets UTF-8. Ne jamais le journaliser. Les URL d’activation doivent utiliser une origine HTTPS configurée.", "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": "Vide uniquement lorsqu'une vérification échouée n'a pas pu résoudre un mappage." }, "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": "Assertion d'identité de courte durée, au maximum 120 secondes ; jamais une attribution en temps réel.", "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": "Le fournisseur de licence actif unique pour tous les produits et les deux environnements.", "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": "Requis pour la première connexion. Omettre ou laisser vide pour conserver la clé côté serveur enregistrée.", "type": "string", "writeOnly": true }, "webhook_secret": { "description": "Secret optionnel de 32 à 256 octets. Omettre ou laisser vide pour conserver le secret enregistré.", "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 de connexion externe ; requis pour custom_http.", "type": "string" }, "environment": { "enum": [ "sandbox", "live" ], "type": "string" }, "mappings": { "items": { "$ref": "#/components/schemas/ExternalMappingInput" }, "type": "array" }, "provider": { "description": "Doit correspondre au fournisseur de licence actif à l’échelle de l’instance. Configurez-le d’abord avec PUT /api/v1/admin/licensing/provider.", "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": "Configuration publique assainie. La provenance de la clé de signature doit être vérifiée par le commerçant.", "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": "Les identifiants de clé sont de 1 à 128 octets UTF-8.", "minLength": 1, "type": "string", "x-maxBytes": 128 }, "type": "object" } }, "required": [ "product_id", "trusted_keys", "base_url" ], "type": "object" }, "PublicProductImport": { "additionalProperties": false, "description": "Configuration publique du produit Launch, remplie à partir de l'ID produit officiel et des clés publiques de signature. Le JSON hérité avec license_key/cache_path et false allow_http vides est accepté et supprimé. Les secrets remplis et les champs inconnus sont rejetés.", "properties": { "allow_http": { "const": false }, "app_version": { "description": "Maximum 80 octets UTF-8.", "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": "Les identifiants de clé sont de 1 à 128 octets UTF-8.", "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": "Aussi renvoyé dans l'en-tête de réponse X-Request-ID", "pattern": "^[a-f0-9]{32}$", "type": "string" }, "SessionGrant": { "properties": { "access_token": { "description": "Renvoyé uniquement pour la connexion depuis un ordinateur de bureau. À traiter comme un secret ; ne jamais mettre dans les URL ou les journaux.", "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": "Session de bureau opaque issue d’auth/login avec kind=desktop.", "scheme": "bearer", "type": "http" }, "websiteCookie": { "description": "Session navigateur. Les mutations nécessitent également que l’Origin et X-CSRF-Token correspondent à launch_csrf.", "in": "cookie", "name": "launch_session", "type": "apiKey" } } }, "info": { "description": "Système, compte, licences de bureau, assistant d'intégration et API d'achat de base. Ce n'est pas le plein API d'administration du personnel / webhook de paiement. L'accès au runtime doit toujours passer par le SDK officiel Licentivo. La vérification par e-mail est requise uniquement lorsqu'elle est activée par le marchand. Les connexions de licence personnalisées et la livraison client sont également documentées. Les points de terminaison des récepteurs externes sont spécifiés séparément dans external-licensing-openapi.json.", "license": { "identifier": "MIT", "name": "MIT" }, "title": "API d'intégration Licentivo Launch", "version": "0.3.4-beta", "x-document-language": "fr" }, "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": "Identité de la connexion, capacités vérifiées et catalogue. Les secrets enregistrés ne sont jamais renvoyés.", "type": "object" }, "request_id": { "type": "string" } }, "required": [ "data" ], "type": "object" } } }, "description": "Réponse réussie" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Configuration/entrée invalide" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Authentification requise" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Administrateur requis, CSRF invalide ou portée interdite" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Aucune ressource possédée" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Mapping immuable, migration requise ou achat non prêt" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Limité par le taux" }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stockage/service externe indisponible" } }, "security": [ { "websiteCookie": [] } ], "summary": "Valider et enregistrer la connexion de gestion Licentivo côté serveur", "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": "L’avis original est programmé pour être retenté" }, "403": { "description": "Privilèges administrateur requis" }, "409": { "description": "Avis complété ou en cours de traitement" } }, "security": [ { "websiteCookie": [] } ], "summary": "Retenter l’avis de révocation de sécurité du compte (admin)" } }, "/api/v1/admin/integration/check": { "post": { "description": "Nécessite le rôle administrateur. Les appels depuis le site doivent fournir Origin et X-CSRF-Token. ready=false signale une configuration incomplète ; aucun champ secret n'est retourné. licentivo_product_id peut être vide dans un rapport incomplet.", "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": "Réponse réussie." }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Champs invalides, ID du produit ou environnement incorrect." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "LOGIN_FAILED (connexion) ou AUTH_REQUIRED (session expirée/révoquée). Supprimez les sessions rejetées ; ne jamais revenir en arrière après un refus explicite." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Interdit, vérification par email requise, changement de mot de passe initial demandé ou refus explicite de droits." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "RATE_LIMITED ; ne pas réessayer en boucle serrée.", "headers": { "Retry-After": { "description": "Secondes à attendre avant une nouvelle tentative. Respectez cette valeur et limitez le nombre total de tentatives.", "schema": { "minimum": 0, "type": "integer" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Échec temporaire du service ou de la base de données. L'accès hors ligne n'est permis que par une autorisation officielle SDK valide et signée." } }, "security": [ { "desktopBearer": [] }, { "websiteCookie": [] } ], "summary": "Lire automatiquement la correspondance logicielle sélectionnée et les clés publiques de signature pour l'initialisation directe du SDK", "tags": [ "Application integration" ] } }, "/api/v1/admin/integration/context": { "get": { "description": "Nécessite le rôle administrateur. Les appels depuis le site doivent fournir Origin et X-CSRF-Token. ready=false signale une configuration incomplète ; aucun champ secret n'est retourné. licentivo_product_id peut être vide dans un rapport incomplet.", "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": "Contexte de déploiement public ; pas de paramètres privés de démarrage" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Champs invalides, ID du produit ou environnement incorrect." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "LOGIN_FAILED (connexion) ou AUTH_REQUIRED (session expirée/révoquée). Supprimez les sessions rejetées ; ne jamais revenir en arrière après un refus explicite." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Interdit, vérification par email requise, changement de mot de passe initial demandé ou refus explicite de droits." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "RATE_LIMITED ; ne pas réessayer en boucle serrée.", "headers": { "Retry-After": { "description": "Secondes à attendre avant une nouvelle tentative. Respectez cette valeur et limitez le nombre total de tentatives.", "schema": { "minimum": 0, "type": "integer" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Échec temporaire du service ou de la base de données. L'accès hors ligne n'est permis que par une autorisation officielle SDK valide et signée." } }, "security": [ { "desktopBearer": [] }, { "websiteCookie": [] } ], "summary": "Lire l’origine du marchand configuré et l’origine fixe de la licence", "tags": [ "Application integration" ] } }, "/api/v1/admin/licensing/connections": { "get": { "operationId": "listLicensingChoices", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LicensingConnectionsResponse" } } }, "description": "Réponse réussie" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Configuration/entrée invalide" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Authentification requise" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Administrateur requis, CSRF invalide ou portée interdite" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Aucune ressource possédée" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Mapping immuable, migration requise ou achat non prêt" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Limité par le taux" }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stockage/service externe indisponible" } }, "security": [ { "desktopBearer": [] }, { "websiteCookie": [] } ], "summary": "Lister les connexions externes, les liaisons et les mappages de produits ; les paramètres Licentivo conservent leur API existante", "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": "Réponse réussie" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Configuration/entrée invalide" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Authentification requise" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Administrateur requis, CSRF invalide ou portée interdite" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Aucune ressource possédée" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Mapping immuable, migration requise ou achat non prêt" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Limité par le taux" }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stockage/service externe indisponible" } }, "security": [ { "desktopBearer": [] }, { "websiteCookie": [] } ], "summary": "Vérifier et enregistrer une connexion HTTP personnalisée pour la licence", "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": "Réponse réussie" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Configuration/entrée invalide" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Authentification requise" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Administrateur requis, CSRF invalide ou portée interdite" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Aucune ressource possédée" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Mapping immuable, migration requise ou achat non prêt" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Limité par le taux" }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stockage/service externe indisponible" } }, "security": [ { "desktopBearer": [] }, { "websiteCookie": [] } ], "summary": "Modifier les métadonnées/les clés de signature ; la destination, l’environnement et la politique réseau sont immuables", "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": "Réponse réussie" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Configuration/entrée invalide" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Authentification requise" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Administrateur requis, CSRF invalide ou portée interdite" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Aucune ressource possédée" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Mapping immuable, migration requise ou achat non prêt" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Limité par le taux" }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stockage/service externe indisponible" } }, "security": [ { "desktopBearer": [] }, { "websiteCookie": [] } ], "summary": "Actualiser les capacités ; last_check_error distingue un échec de vérification dans la réponse 200", "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": "Réponse réussie" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Configuration/entrée invalide" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Authentification requise" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Administrateur requis, CSRF invalide ou portée interdite" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Aucune ressource possédée" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Mapping immuable, migration requise ou achat non prêt" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Limité par le taux" }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stockage/service externe indisponible" } }, "security": [ { "desktopBearer": [] }, { "websiteCookie": [] } ], "summary": "Activer un fournisseur de licence pour toute l’instance ; un changement nécessite une migration si d’autres commandes existent", "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": "Réponse réussie" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Configuration/entrée invalide" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Authentification requise" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Administrateur requis, CSRF invalide ou portée interdite" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Aucune ressource possédée" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Mapping immuable, migration requise ou achat non prêt" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Limité par le taux" }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stockage/service externe indisponible" } }, "security": [ { "desktopBearer": [] }, { "websiteCookie": [] } ], "summary": "Configurer la connexion produit et les mappings de plan pour un environnement en utilisant le fournisseur de licence actif", "tags": [ "Custom licensing" ] } }, "/api/v1/admin/refunds/{id}/reconcile": { "post": { "description": "L'administrateur vérifie le remboursement original et restaure la même opération après avoir vérifié la transaction originale, le montant et la devise à partir du reçu du canal. S'il n'y a pas de reçu, il faut seulement réessayer la demande idempotente originale dans les 23 heures suivant l'heure d'approbation originale sur Stripe/PayPal ; au-delà de cette période, le numéro de remboursement original du canal est requis. L'opération est enregistrée dans l'audit, et aucun nouveau numéro d'opération de remboursement n'est créé.", "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": "La tâche originale a été remise en file d'attente" }, "403": { "description": "Privilèges d'administrateur et identifiants CSRF valides requis" }, "409": { "description": "Conflit de statut, discordance de reçu ou numéro de remboursement original du canal requis" }, "503": { "description": "La requête du canal original temporairement indisponible" } }, "security": [ { "websiteCookie": [] } ], "summary": "Vérifier et restaurer la tâche de remboursement originale" } }, "/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": "Réponse réussie." }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Champs invalides, ID du produit ou environnement incorrect." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "LOGIN_FAILED (connexion) ou AUTH_REQUIRED (session expirée/révoquée). Supprimez les sessions rejetées ; ne jamais revenir en arrière après un refus explicite." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Interdit, vérification par email requise, changement de mot de passe initial demandé ou refus explicite de droits." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "RATE_LIMITED ; ne pas réessayer en boucle serrée.", "headers": { "Retry-After": { "description": "Secondes à attendre avant une nouvelle tentative. Respectez cette valeur et limitez le nombre total de tentatives.", "schema": { "minimum": 0, "type": "integer" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Échec temporaire du service ou de la base de données. L'accès hors ligne n'est permis que par une autorisation officielle SDK valide et signée." } }, "security": [], "summary": "Complétez un identifiant email à usage unique", "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": "Réponse réussie." }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Champs invalides, ID du produit ou environnement incorrect." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "LOGIN_FAILED (connexion) ou AUTH_REQUIRED (session expirée/révoquée). Supprimez les sessions rejetées ; ne jamais revenir en arrière après un refus explicite." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Interdit, vérification par email requise, changement de mot de passe initial demandé ou refus explicite de droits." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "RATE_LIMITED ; ne pas réessayer en boucle serrée.", "headers": { "Retry-After": { "description": "Secondes à attendre avant une nouvelle tentative. Respectez cette valeur et limitez le nombre total de tentatives.", "schema": { "minimum": 0, "type": "integer" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Échec temporaire du service ou de la base de données. L'accès hors ligne n'est permis que par une autorisation officielle SDK valide et signée." } }, "security": [], "summary": "Demandez un email de vérification ou de récupération de mot de passe", "tags": [ "Application integration" ] } }, "/api/v1/auth/identity-keys": { "get": { "operationId": "launchIdentityPublicKeys", "responses": { "200": { "description": "Clés publiques Ed25519 ; jamais de matériel de signature privé" } }, "summary": "Clés de signature publiques épinglées pour l’identité de compte Launch" } }, "/api/v1/auth/login": { "post": { "description": "Définissez kind=desktop pour les applications et omettez l’en-tête Origin du navigateur. La connexion au site web définit des cookies et omet access_token.", "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": "Réponse réussie." }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Champs invalides, ID du produit ou environnement incorrect." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "LOGIN_FAILED (connexion) ou AUTH_REQUIRED (session expirée/révoquée). Supprimez les sessions rejetées ; ne jamais revenir en arrière après un refus explicite." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Interdit, vérification par email requise, changement de mot de passe initial demandé ou refus explicite de droits." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "RATE_LIMITED ; ne pas réessayer en boucle serrée.", "headers": { "Retry-After": { "description": "Secondes à attendre avant une nouvelle tentative. Respectez cette valeur et limitez le nombre total de tentatives.", "schema": { "minimum": 0, "type": "integer" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Échec temporaire du service ou de la base de données. L'accès hors ligne n'est permis que par une autorisation officielle SDK valide et signée." } }, "security": [], "summary": "Connectez-vous au site web ou sur le bureau", "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": "Réponse réussie." }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Champs invalides, ID du produit ou environnement incorrect." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "LOGIN_FAILED (connexion) ou AUTH_REQUIRED (session expirée/révoquée). Supprimez les sessions rejetées ; ne jamais revenir en arrière après un refus explicite." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Interdit, vérification par email requise, changement de mot de passe initial demandé ou refus explicite de droits." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "RATE_LIMITED ; ne pas réessayer en boucle serrée.", "headers": { "Retry-After": { "description": "Secondes à attendre avant une nouvelle tentative. Respectez cette valeur et limitez le nombre total de tentatives.", "schema": { "minimum": 0, "type": "integer" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Échec temporaire du service ou de la base de données. L'accès hors ligne n'est permis que par une autorisation officielle SDK valide et signée." } }, "security": [ { "desktopBearer": [] }, { "websiteCookie": [] } ], "summary": "Révoquez la session en cours ; la fermeture du SDK, le nettoyage local et la libération de l’appareil restent des actions distinctes", "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 octets UTF-8 (le serveur compte les octets, pas les caractères Unicode).", "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": "Réponse réussie." }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Champs invalides, ID du produit ou environnement incorrect." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "LOGIN_FAILED (connexion) ou AUTH_REQUIRED (session expirée/révoquée). Supprimez les sessions rejetées ; ne jamais revenir en arrière après un refus explicite." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Interdit, vérification par email requise, changement de mot de passe initial demandé ou refus explicite de droits." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "RATE_LIMITED ; ne pas réessayer en boucle serrée.", "headers": { "Retry-After": { "description": "Secondes à attendre avant une nouvelle tentative. Respectez cette valeur et limitez le nombre total de tentatives.", "schema": { "minimum": 0, "type": "integer" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Échec temporaire du service ou de la base de données. L'accès hors ligne n'est permis que par une autorisation officielle SDK valide et signée." } }, "security": [], "summary": "Enregistrer un client ; la vérification suit les paramètres d'email du commerçant", "tags": [ "Application integration" ] } }, "/api/v1/licensing/documentation": { "get": { "operationId": "readExternalLicensingGuide", "responses": { "200": { "content": { "text/plain": { "schema": { "type": "string" } } }, "description": "Document public" } }, "security": [], "summary": "Documentation de licence externe publique" } }, "/api/v1/licensing/protocol": { "get": { "operationId": "readExternalLicensingProtocol", "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "Document public" } }, "security": [], "summary": "Documentation de licence externe publique" } }, "/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": "Réponse réussie." }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Champs invalides, ID du produit ou environnement incorrect." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "LOGIN_FAILED (connexion) ou AUTH_REQUIRED (session expirée/révoquée). Supprimez les sessions rejetées ; ne jamais revenir en arrière après un refus explicite." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Interdit, vérification par email requise, changement de mot de passe initial demandé ou refus explicite de droits." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "RATE_LIMITED ; ne pas réessayer en boucle serrée.", "headers": { "Retry-After": { "description": "Secondes à attendre avant une nouvelle tentative. Respectez cette valeur et limitez le nombre total de tentatives.", "schema": { "minimum": 0, "type": "integer" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Échec temporaire du service ou de la base de données. L'accès hors ligne n'est permis que par une autorisation officielle SDK valide et signée." } }, "security": [ { "desktopBearer": [] }, { "websiteCookie": [] } ], "summary": "Lisez le compte authentifié", "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": "Réponse réussie." }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Champs invalides, ID du produit ou environnement incorrect." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "LOGIN_FAILED (connexion) ou AUTH_REQUIRED (session expirée/révoquée). Supprimez les sessions rejetées ; ne jamais revenir en arrière après un refus explicite." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Interdit, vérification par email requise, changement de mot de passe initial demandé ou refus explicite de droits." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "RATE_LIMITED ; ne pas réessayer en boucle serrée.", "headers": { "Retry-After": { "description": "Secondes à attendre avant une nouvelle tentative. Respectez cette valeur et limitez le nombre total de tentatives.", "schema": { "minimum": 0, "type": "integer" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Échec temporaire du service ou de la base de données. L'accès hors ligne n'est permis que par une autorisation officielle SDK valide et signée." } }, "security": [ { "desktopBearer": [] }, { "websiteCookie": [] } ], "summary": "Lister les commandes actuelles du client", "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": "Réponse réussie" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Configuration/entrée invalide" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Authentification requise" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Administrateur requis, CSRF invalide ou portée interdite" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Aucune ressource possédée" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Mapping immuable, migration requise ou achat non prêt" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Limité par le taux" }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Stockage/service externe indisponible" } }, "security": [ { "desktopBearer": [] }, { "websiteCookie": [] } ], "summary": "Lire la livraison externe actuelle possédée ; jamais une décision d’autorisation en temps réel", "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": "Réponse réussie." }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Champs invalides, ID du produit ou environnement incorrect." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "LOGIN_FAILED (connexion) ou AUTH_REQUIRED (session expirée/révoquée). Supprimez les sessions rejetées ; ne jamais revenir en arrière après un refus explicite." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Interdit, vérification par email requise, changement de mot de passe initial demandé ou refus explicite de droits." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "RATE_LIMITED ; ne pas réessayer en boucle serrée.", "headers": { "Retry-After": { "description": "Secondes à attendre avant une nouvelle tentative. Respectez cette valeur et limitez le nombre total de tentatives.", "schema": { "minimum": 0, "type": "integer" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Échec temporaire du service ou de la base de données. L'accès hors ligne n'est permis que par une autorisation officielle SDK valide et signée." } }, "security": [ { "desktopBearer": [] }, { "websiteCookie": [] } ], "summary": "Listez les sessions de compte actives", "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": "Réponse réussie." }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Champs invalides, ID du produit ou environnement incorrect." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "LOGIN_FAILED (connexion) ou AUTH_REQUIRED (session expirée/révoquée). Supprimez les sessions rejetées ; ne jamais revenir en arrière après un refus explicite." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Interdit, vérification par email requise, changement de mot de passe initial demandé ou refus explicite de droits." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "RATE_LIMITED ; ne pas réessayer en boucle serrée.", "headers": { "Retry-After": { "description": "Secondes à attendre avant une nouvelle tentative. Respectez cette valeur et limitez le nombre total de tentatives.", "schema": { "minimum": 0, "type": "integer" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Échec temporaire du service ou de la base de données. L'accès hors ligne n'est permis que par une autorisation officielle SDK valide et signée." } }, "security": [ { "desktopBearer": [] }, { "websiteCookie": [] } ], "summary": "Révoquez une session possédée", "tags": [ "Application integration" ] } }, "/api/v1/orders": { "post": { "description": "Les prix sont calculés sur le serveur. Le renouvellement et la mise à niveau nécessitent un devis émis par le serveur. Suivez le paiement hébergé ; le retour de redirection n'est pas une preuve de paiement.", "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": "Identifiant stable de l'opération, 16 à 80 octets UTF-8. Réutilisez la même clé pour les tentatives de la même opération.", "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": "Réponse réussie." }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Champs invalides, ID du produit ou environnement incorrect." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "LOGIN_FAILED (connexion) ou AUTH_REQUIRED (session expirée/révoquée). Supprimez les sessions rejetées ; ne jamais revenir en arrière après un refus explicite." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Interdit, vérification par email requise, changement de mot de passe initial demandé ou refus explicite de droits." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "RATE_LIMITED ; ne pas réessayer en boucle serrée.", "headers": { "Retry-After": { "description": "Secondes à attendre avant une nouvelle tentative. Respectez cette valeur et limitez le nombre total de tentatives.", "schema": { "minimum": 0, "type": "integer" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Échec temporaire du service ou de la base de données. L'accès hors ligne n'est permis que par une autorisation officielle SDK valide et signée." } }, "security": [ { "desktopBearer": [] }, { "websiteCookie": [] } ], "summary": "Créer ou récupérer un paiement possédé en utilisant une clé d'idempotence stable", "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": "Réponse réussie." }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Champs invalides, ID du produit ou environnement incorrect." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "LOGIN_FAILED (connexion) ou AUTH_REQUIRED (session expirée/révoquée). Supprimez les sessions rejetées ; ne jamais revenir en arrière après un refus explicite." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Interdit, vérification par email requise, changement de mot de passe initial demandé ou refus explicite de droits." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "RATE_LIMITED ; ne pas réessayer en boucle serrée.", "headers": { "Retry-After": { "description": "Secondes à attendre avant une nouvelle tentative. Respectez cette valeur et limitez le nombre total de tentatives.", "schema": { "minimum": 0, "type": "integer" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Échec temporaire du service ou de la base de données. L'accès hors ligne n'est permis que par une autorisation officielle SDK valide et signée." } }, "security": [ { "desktopBearer": [] }, { "websiteCookie": [] } ], "summary": "Lire une commande possédée et le progrès de l'exécution", "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": "Réponse réussie." }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Champs invalides, ID du produit ou environnement incorrect." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "LOGIN_FAILED (connexion) ou AUTH_REQUIRED (session expirée/révoquée). Supprimez les sessions rejetées ; ne jamais revenir en arrière après un refus explicite." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Interdit, vérification par email requise, changement de mot de passe initial demandé ou refus explicite de droits." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "RATE_LIMITED ; ne pas réessayer en boucle serrée.", "headers": { "Retry-After": { "description": "Secondes à attendre avant une nouvelle tentative. Respectez cette valeur et limitez le nombre total de tentatives.", "schema": { "minimum": 0, "type": "integer" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Échec temporaire du service ou de la base de données. L'accès hors ligne n'est permis que par une autorisation officielle SDK valide et signée." } }, "security": [ { "desktopBearer": [] }, { "websiteCookie": [] } ], "summary": "Interroger le fournisseur de paiement pour une commande détenue", "tags": [ "Application integration" ] } }, "/api/v1/software/products/{id}/credential": { "post": { "deprecated": true, "description": "Les sessions du navigateur ne peuvent pas récupérer les clés de licence. Aucun ID utilisateur choisi par le client n’est accepté. 403 ENTITLEMENT_PENDING inclut Retry-After : 3 ; les tentatives doivent être limitées. EXPIRED/SUSPENDED nécessitent une action de l’utilisateur. 404 ENTITLEMENT_NOT_PURCHASED signifie qu’aucun droit possédé n’existe.", "operationId": "softwareCredential", "parameters": [ { "description": "ID produit Launch, pas l’ID produit Licentivo.", "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 ; aucune clé de licence n’est renvoyée" } }, "security": [ { "desktopBearer": [] } ], "summary": "Supprimé : les SDK de compte doivent utiliser l’échange d’identité", "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": "Contexte d’identité uniquement. Licentivo décide de l’autorisation." }, "401": { "description": "Session de compte rejetée" }, "503": { "description": "Connexion d’identité indisponible" } }, "security": [ { "desktopBearer": [] } ], "summary": "Obtenir une assertion d’identité de compte à courte durée pour le SDK officiel" } }, "/api/v1/software/products/{id}/status": { "get": { "description": "Il s'agit d'informations d'achat/synchronisation, pas d'une autorisation d'exécution.", "operationId": "softwareStatus", "parameters": [ { "description": "ID produit Launch, pas l’ID produit Licentivo.", "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": "Réponse réussie." }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Champs invalides, ID du produit ou environnement incorrect." }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "LOGIN_FAILED (connexion) ou AUTH_REQUIRED (session expirée/révoquée). Supprimez les sessions rejetées ; ne jamais revenir en arrière après un refus explicite." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Interdit, vérification par email requise, changement de mot de passe initial demandé ou refus explicite de droits." }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "RATE_LIMITED ; ne pas réessayer en boucle serrée.", "headers": { "Retry-After": { "description": "Secondes à attendre avant une nouvelle tentative. Respectez cette valeur et limitez le nombre total de tentatives.", "schema": { "minimum": 0, "type": "integer" } } } }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "description": "Échec temporaire du service ou de la base de données. L'accès hors ligne n'est permis que par une autorisation officielle SDK valide et signée." } }, "security": [ { "desktopBearer": [] } ], "summary": "Lire le statut actionnable pour le client authentifié et le produit demandé", "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": "Phase de développement actuelle et portée de l'implémentation" } }, "summary": "Expose la version et la portée de l'implémentation sans configuration ni identifiants" } }, "/healthz": { "get": { "operationId": "getLiveness", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HealthResponse" } } }, "description": "Le processus HTTP est en cours d'exécution" } }, "summary": "Traiter la vivacité, indépendamment de la disponibilité de la base de données" } }, "/readyz": { "get": { "operationId": "getReadiness", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReadinessResponse" } } }, "description": "La base de données est prête ; cela ne certifie pas l'acceptation du paiement ou de la licence" }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReadinessResponse" } } }, "description": "La base de données n'est pas configurée, indisponible ou dépourvue des tables requises" } }, "summary": "Vérifier la connectivité MySQL et les tables GORM requises" } } }, "servers": [ { "description": "Remplacez par l'origine de votre marchand ; HTTP n'est permis que pour le développement sandbox en loopback.", "url": "https://shop.example.com" } ] }