> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scanova.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Téléverser un certificat SSL
> POST /custom-domain/{pk}/ssl-certificate/
Téléverse un certificat SSL émis pour un domaine et l'active, sur l'hôte de l'**API de gestion** (`api.scanova.io`), authentifié avec votre clé d'API de gestion brute.
```
POST https://api.scanova.io/custom-domain/{pk}/ssl-certificate/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
```
Réservé à l'offre Enterprise. Nécessite le quota `CUSTOM_DOMAIN_CUSTOM_SSL`, accordé manuellement — aucun plan en libre-service ne l'inclut. Nécessite une CSR préalable — voir [Créer une demande de certificat SSL](/fr/api-reference/management-api/custom-domain/certificate-request-create).
Le `id` du domaine.
Le certificat émis, encodé en PEM.
La chaîne intermédiaire de l'autorité de certification, encodée en PEM, si votre AC en fournit une séparément.
```bash cURL theme={null}
curl -X POST "https://api.scanova.io/custom-domain/42/ssl-certificate/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{
"certificate": "-----BEGIN CERTIFICATE-----\nMIID...\n-----END CERTIFICATE-----",
"certificate_chain": "-----BEGIN CERTIFICATE-----\nMIID...\n-----END CERTIFICATE-----"
}'
```
```json 200 theme={null}
{
"detail": "Certificate activated.",
"status": "ISSUED",
"expires_at": "2026-12-08T00:00:00Z"
}
```
Scanova valide le certificat par rapport au domaine et à la clé de la CSR, l'importe dans AWS ACM, et le lie pour servir le trafic réel — c'est entièrement automatisé, sans étape de révision manuelle. Trois résultats sont possibles :
* **`200`** — validé, importé et activé. Le trafic sur ce domaine est désormais servi avec le nouveau certificat.
* **`202`** — importé dans ACM mais pas encore émis ; pas encore lié pour servir le trafic. Revérifiez sous peu.
* **`207` Multi-Status** — émis, mais la liaison pour servir le trafic a échoué ; l'équipe support de Scanova en a été automatiquement informée et assurera le suivi.
`400` s'il n'existe pas encore de CSR pour ce domaine, si le certificat ne correspond pas au domaine ou à la clé de la CSR, ou si AWS ACM rejette l'import (le message d'erreur est inclus dans la réponse).
## Voir aussi
* [Obtenir le statut du certificat SSL](/fr/api-reference/management-api/custom-domain/ssl-certificate-retrieve) — vérifier le statut après téléversement.
* [Créer une demande de certificat SSL](/fr/api-reference/management-api/custom-domain/certificate-request-create) — la CSR requise avant le téléversement.
* [Présentation de l'API de gestion](/fr/api-reference/management-api/overview) — le schéma d'authentification et les règles de quota applicables à cet endpoint.
## OpenAPI
````yaml api-reference/openapi/management-api.json POST /custom-domain/{pk}/ssl-certificate/
openapi: 3.1.0
info:
title: Scanova Management API (v2)
description: >-
The complete Scanova Management API — every endpoint available at
api.scanova.io (QR codes, folders, tags, leads, forms, analytics, plans,
shared users & roles), plus the token-creation and usage-stats endpoints
used to authenticate against it. Every path and request/response shape below
was verified live against a real API key and the actual running backend
(Phase 7, 2026-08-16) — not guessed from reading urls.py alone.
version: 2.0.0
servers:
- url: https://api.scanova.io
description: Management API — QR/folder/tag/lead/form/analytics/plans endpoints
security:
- apiKeyAuth: []
paths:
/custom-domain/{pk}/ssl-certificate/:
post:
summary: Upload an SSL certificate
description: >-
Requires a prior CSR (see Create an SSL certificate request). Validates
the certificate against the domain and the CSR's key, imports it into
AWS ACM, and links it for serving traffic. A `202` means ACM accepted
the import but hasn't finished issuing; a `207` means activation partly
failed and support was notified automatically.
operationId: uploadSslCertificate
parameters:
- name: pk
in: path
required: true
schema:
type: integer
requestBody:
content:
application/json:
example:
certificate: '-----BEGIN CERTIFICATE-----\nMIID...\n-----END CERTIFICATE-----'
certificate_chain: '-----BEGIN CERTIFICATE-----\nMIID...\n-----END CERTIFICATE-----'
responses:
'200':
description: Certificate validated, imported, and activated for serving traffic.
content:
application/json:
example:
detail: Certificate activated.
status: ISSUED
expires_at: '2026-12-08T00:00:00Z'
'202':
description: >-
Certificate imported into ACM but not yet issued; not linked to
serve traffic yet.
content:
application/json:
example:
detail: Certificate imported but not yet issued. Check back shortly.
'207':
description: >-
Certificate issued but linking it to serve traffic failed; support
has been notified automatically.
content:
application/json:
example:
detail: >-
Certificate issued, but activation needs manual follow-up. Our
team has been notified.
'400':
description: >-
No CSR exists for this domain yet, the certificate doesn't match the
domain/CSR key, or AWS ACM rejected the import (error message
included).
components:
securitySchemes:
apiKeyAuth:
type: apiKey
in: header
name: Authorization
description: >-
Send your Management API key as the raw value of the Authorization
header — no "Bearer " or "Token " prefix, and no other characters.
Example: `Authorization: 401f7ac837da42b97f613d789819ff93537bee6a`. A
header containing more than one space-separated part is rejected
outright. Requests also require the request's Host header to be the
management API host (e.g. api.scanova.io) — the same key sent to the
regular API host will not authenticate.
````