Domaines personnalisés

Un site peut être relié à un domaine personnalisé (par exemple friterie-william.be), avec ou sans www. Fonction réservée aux formules payantes. Le guide pas à pas pour les commerçants se trouve dans Votre adresse web.

Fonctionnement#

Vous reliez le domaine : Monsiteo renvoie les enregistrements DNS à poser chez le registrar.
Toutes les 10 minutes, Monsiteo vérifie automatiquement le DNS des domaines en attente (vous pouvez aussi forcer une vérification).
Quand l'enregistrement A et la preuve TXT sont trouvés (et le www si demandé), le domaine passe en verified et le certificat SSL est demandé automatiquement.
Une fois le certificat émis, le domaine passe en active : le site répond sur le domaine et l'adresse en .monsiteo.com redirige vers lui. Le propriétaire reçoit un e-mail.

Sans succès après environ 72 heures de vérifications automatiques (432 essais), le domaine passe en failed ; une vérification manuelle réussie le remet en route. Un domaine actif est revérifié une fois par jour.

L'objet domaine#

Champ	Type	Description
`id`	entier	Identifiant.
`host`	chaîne	Domaine sans `www`, en minuscules (`friterie-william.be`). Les noms accentués sont convertis en punycode.
`with_www`	booléen	Le site répond aussi sur `www.` (et c'est l'adresse principale).
`status`	chaîne	`pending` (en attente du DNS), `verified` (DNS correct, SSL en cours), `active` (en ligne en HTTPS), `failed` (abandon après 72 h).
`ssl_status`	chaîne	`none`, `queued` (en file), `issuing` (en cours d'émission), `active`, `failed`.
`last_error`	chaîne ou `null`	Explication du dernier échec, en français.
`last_checked_at`	date ou `null`	Dernière vérification.
`verified_at`	date ou `null`	Date de la vérification réussie.
`records`	tableau	Enregistrements DNS à poser.

Chaque élément de records contient type (A, CNAME ou TXT), name (nom relatif à saisir chez la plupart des registrars), host (nom complet) et value.

Lire le domaine#

GET /v1/sites/{site}/domain · Jeton

curl https://api.monsiteo.com/v1/sites/7/domain \
  -H "Accept: application/json" \
  -H "Authorization: Bearer 1|AbCdEfGhIjKlMnOpQrStUvWxYz0123456789abcd"

{
  "data": {
    "id": 3,
    "host": "friterie-william.be",
    "with_www": true,
    "status": "pending",
    "ssl_status": "none",
    "last_error": "L'enregistrement A de friterie-william.be ne pointe pas encore vers 51.91.14.237. L'enregistrement TXT _monsiteo.friterie-william.be est introuvable.",
    "last_checked_at": "2026-10-26T09:40:00+00:00",
    "verified_at": null,
    "records": [
      { "type": "A", "name": "@", "host": "friterie-william.be", "value": "51.91.14.237" },
      { "type": "CNAME", "name": "www", "host": "www.friterie-william.be", "value": "friterie-william.monsiteo.com." },
      { "type": "TXT", "name": "_monsiteo", "host": "_monsiteo.friterie-william.be", "value": "monsiteo-verification=k2m9x7q4w1z8c5v3b6n0p2r4t6y8u1i3" }
    ]
  }
}

Sans domaine relié : {"data": null}.

Relier un domaine#

POST /v1/sites/{site}/domain · Jeton

Paramètre	Type	Obligatoire	Règles
`host`	chaîne	oui	253 caractères max. ; `https://`, chemin, port, point final et `www.` sont retirés automatiquement
`with_www`	booléen	non	`true` par défaut

Attention Un site n'a qu'un domaine : relier un nouveau domaine remplace l'ancien, qui cesse de fonctionner.

curl -X POST https://api.monsiteo.com/v1/sites/7/domain \
  -H "Accept: application/json" -H "Content-Type: application/json" \
  -H "Authorization: Bearer 1|AbCdEfGhIjKlMnOpQrStUvWxYz0123456789abcd" \
  -d '{"host":"https://www.friterie-william.be/","with_www":true}'

Réponse 201 : l'objet domaine dans data, avec "status": "pending", "ssl_status": "none" et les records à poser chez votre registrar.

Erreurs :

402 : « Le domaine personnalisé est inclus dans les formules payantes. » ;
422 sur host : « Ce nom de domaine n'est pas valide. », « Les adresses en .monsiteo.com sont gérées automatiquement. », « Ce domaine est déjà relié a un site Monsiteo. ».

Vérifier maintenant#

POST /v1/sites/{site}/domain/verify · Jeton · 12 requêtes par minute

Lance immédiatement la vérification DNS (sans attendre le passage automatique) et renvoie l'état à jour.

curl -X POST https://api.monsiteo.com/v1/sites/7/domain/verify \
  -H "Accept: application/json" \
  -H "Authorization: Bearer 1|AbCdEfGhIjKlMnOpQrStUvWxYz0123456789abcd"

Réponse 200 : l'objet domaine dans data. Si tout est correct, status passe à verified et ssl_status à queued, puis quelques minutes plus tard à active. Sinon last_error explique ce qui manque :

Message	Cause
« L'enregistrement A de ... ne pointe pas encore vers 51.91.14.237. »	Enregistrement A absent, erroné ou pas encore propagé.
« L'enregistrement TXT _monsiteo.... est introuvable. »	Preuve de propriété absente ou valeur incorrecte.
« Le sous-domaine www ne pointe pas encore vers Monsiteo. »	CNAME `www` absent (vérifié seulement quand A et TXT sont bons).

Erreurs : 403, 404 (aucun domaine relié), 429.

Bon à savoir Les modifications DNS peuvent mettre de quelques minutes à 48 heures pour être visibles partout. Inutile d'appeler cette route en boucle : la vérification automatique toutes les 10 minutes s'en charge.

Retirer le domaine#

DELETE /v1/sites/{site}/domain · Jeton

Le site redevient accessible uniquement sur son adresse .monsiteo.com.

curl -X DELETE https://api.monsiteo.com/v1/sites/7/domain \
  -H "Accept: application/json" \
  -H "Authorization: Bearer 1|AbCdEfGhIjKlMnOpQrStUvWxYz0123456789abcd"

{ "ok": true }