Aller au contenu
Host

Tape un mot pour chercher dans les pages.

↑↓ Choisir↵ OuvrirÉchap Fermer
Ouvrir Host

Référence

Domaines

Lister, ajouter, vérifier et retirer les domaines d'un projet par l'API, comme avec vercel domains.

Les domaines d’un projet se gèrent comme chez Vercel. Ajouter et retirer demandent la portée host:domains ; lire, host:read. Un domaine ajouté attend son enregistrement TXT de preuve et son CNAME (ou A et AAAA pour un domaine racine) : voir Brancher un domaine.

GET /v9/projects/:p/domains

Liste les domaines du projet. Chaque domaine porte verified et, tant qu’il n’est pas vérifié, verification : l’enregistrement TXT à publier.

POST /v10/projects/:p/domains

Ajoute un domaine. Corps : name, et en option redirect (autre domaine du projet), redirectStatusCode, gitBranch. Un domaine de la plateforme (hgdc.cloud, hgdc.ch) ou déjà vérifié par une autre organisation répond 400.

La CLI passe par POST /projects/:p/alias (vercel domains add <domaine> <projet>), qui fait la même chose.

GET /v9/projects/:p/domains/:domain

Lit un domaine du projet.

POST /v9/projects/:p/domains/:domain/verify

Relance la vérification DNS. Limitée par organisation.

DELETE /v9/projects/:p/domains/:domain

Retire le domaine. Un domaine vers lequel un autre redirige répond 400 : retire d’abord la redirection.

Domaines de l’organisation

GET /v5/domains (vercel domains ls), GET /v5/domains/:domain (vercel domains inspect), GET /v6/domains/:domain/config, GET /v1/domains/:domain/project-domains et DELETE /v3/domains/:domain (vercel domains rm) lisent et retirent les domaines de tous les projets de l’organisation. Ajouter un domaine sans projet n’existe pas : précise le projet.