Sous-domaines Jamdesk
Votre sous-domaine par défaut yourproject.jamdesk.app -- règles de nommage, comment le modifier, et quand passer à un domaine personnalisé.
Chaque projet Jamdesk bénéficie d'un sous-domaine gratuit sur yourproject.jamdesk.app. Il s'agit de votre URL de documentation par défaut, disponible immédiatement après votre premier déploiement.
Fonctionnement des sous-domaines
Lorsque vous créez un projet, Jamdesk attribue automatiquement un sous-domaine basé sur le slug de votre projet :
| Slug du projet | Sous-domaine |
|---|---|
my-docs | my-docs.jamdesk.app |
acme-api | acme-api.jamdesk.app |
company-help | company-help.jamdesk.app |
Votre sous-domaine est actif dès que votre premier build est terminé.
Règles de nommage des sous-domaines
Les sous-domaines doivent respecter ces règles :
- Lettres minuscules, chiffres et tirets uniquement
- Doit commencer par une lettre
- Ne peut pas commencer ou se terminer par un tiret
- Entre 3 et 63 caractères
- Doit être unique parmi tous les projets Jamdesk
Modifier votre sous-domaine
Pour modifier votre sous-domaine :
- Accédez à votre projet dans le dashboard
- Ouvrez Paramètres → Général
- Mettez à jour le champ Slug du projet
- Cliquez sur Enregistrer
Modifier votre sous-domaine rompt les liens existants. Les moteurs de recherche et les sites externes qui pointent vers votre ancien sous-domaine obtiendront des erreurs 404. Envisagez plutôt de configurer un domaine personnalisé si vous avez besoin de stabilité des URL.
Après modification :
- Votre nouveau sous-domaine est actif immédiatement
- L'ancien sous-domaine renvoie une erreur 404
- Les favoris et les liens externes sont rompus
- Le classement dans les moteurs de recherche est réinitialisé
Certificats SSL
Les certificats SSL sont automatiquement provisionnés pour tous les sous-domaines *.jamdesk.app. HTTPS est obligatoire — les requêtes HTTP sont redirigées vers HTTPS.
Limites de débit
Les sous-domaines Jamdesk partagent l'infrastructure avec d'autres projets. Pour une documentation à fort trafic :
- Envisagez un domaine personnalisé pour des ressources dédiées
- Contactez le support si vous prévoyez un trafic élevé soutenu
Quand utiliser un domaine personnalisé
Utilisez un domaine personnalisé lorsque :
- Vous avez besoin de stabilité des URL (les modifications de sous-domaine rompent les liens)
- Vous souhaitez héberger votre documentation sur
docs.votreentreprise.com - Vous devez correspondre au domaine de votre entreprise
- Votre documentation est destinée à vos clients
Consultez Domaines personnalisés pour les instructions de configuration.
Sous-domaine vs. domaine personnalisé
| Fonctionnalité | Sous-domaine | Domaine personnalisé |
|---|---|---|
| Temps de configuration | Instantané | 10-30 minutes |
| Coût | Gratuit | Gratuit (vous fournissez le domaine) |
| Format URL | project.jamdesk.app | docs.votredomaine.com |
| SSL | Automatique | Automatique |
| Image de marque | Marque Jamdesk | Votre marque |
| Stabilité URL | Liée au slug du projet | Permanente |