Déploiement
Déploiement • Chapitre 8 : Configuration d'un nom de domaine et du DNS

Configuration d'un sous-domaine pour une API

Isolez votre backend avec élégance : créez un sous-domaine dédié comme api.mon-site.com pour découpler totalement l'infrastructure du serveur applicatif et clarifier vos endpoints de production.

🏷️
Préfixe api.

Sous-domaine normalisé dans l'industrie pour héberger les services REST et GraphQL.

🌐
Machines Indépendantes

Permet au frontend et à l'API de résider sur des serveurs et continents différents.

🍪
Partage de Cookies

Configuration de Domain=.mon-site.com pour partager les sessions entre frontend et API.

📜
Certificat Wildcard

Un certificat *.mon-site.com sécurise à la fois le domaine et tous ses sous-domaines.

subdomain-dns-record.txt
# 1. Ajout de l'enregistrement DNS pour le sous-domaine 'api'
# Chez le Registrar / Zone DNS :
# Nom d'hôte : api
# Type      : A
# Valeur    : 198.51.100.88 (Adresse IP du serveur VPS où tourne l'API Express)
# TTL       : 300

# 2. Vérification immédiate de la résolution du sous-domaine
$ dig api.mon-site.com +short
198.51.100.88

# 3. Validation de l'accès au serveur Nginx de l'API
$ curl -I https://api.mon-site.com/health
HTTP/2 200 
content-type: application/json; charset=utf-8

Guide Approfondi & Architecture Système

1. Pourquoi dédier un sous-domaine plutôt que de tout mélanger ?

Dans les architectures d'entreprise modernes :
  • Le frontend mon-site.com est hébergé sur un CDN mondial (Vercel ou Cloudflare Pages) pour charger en 15 ms partout sur Terre.
  • L'API api.mon-site.com est hébergée sur un serveur Linux puissant à Francfort ou Paris, au plus près de votre base de données MySQL.

Grâce au sous-domaine, vous pouvez changer d'hébergeur pour l'API sans jamais toucher au frontend, et vice-versa.

2. Attention aux Cookies de Session (SameSite & Domain)

Si votre application utilise des cookies HTTP-Only pour l'authentification :
Partage de cookies entre sous-domaines : Par défaut, un cookie émis par api.mon-site.com n'est pas lu par mon-site.com. Pour autoriser le partage, vous devez définir l'attribut Domain=.mon-site.com (avec un point devant) et SameSite=Lax ou SameSite=None avec Secure=true.

Tableau Comparatif : Sous-Domaine (api.site.com) vs Sous-Chemin (site.com/api)

Aspect d'IngénierieSous-Domaine (api.mon-site.com)Sous-Chemin (mon-site.com/api)
Hébergement physiquePeut être sur deux serveurs / hébergeurs 100% distinctsExige un reverse proxy ou d'être sur la même machine
Politique CORSCORS obligatoire (car origines différentes)Zéro problème CORS (même origine)
Certificat SSLCertificat distinct ou Wildcard (*.site.com)Un seul certificat standard suffit
Maintenance d'équipeÉquipes frontend et backend totalement autonomesNécessite de synchroniser les configurations Nginx