Domaines personnalisés

Un projet peut servir son API depuis un domaine que vous vérifiez, et une application de connexion peut servir la page de connexion hébergée depuis un domaine. Les deux sont facultatifs, et chacun a un domaine Fóir par défaut tant que vous ne le configurez pas.

Un domaine d'API pour un projet

Enregistrez un nom d'hôte dans la console sous Paramètres, puis Domaines d'API. Une fois vérifié, l'API du projet y répond comme sur le domaine par défaut api.foir.dev. Votre domaine sert les requêtes et abonnements GraphQL, le point d'accès au schéma utilisé pour la génération de code et les points d'accès de téléversement de fichiers. La mise en cache, les limites de débit et les erreurs sont identiques sur les deux noms d'hôte.

Un domaine de connexion pour une application de connexion

Un domaine de connexion appartient à une seule application de connexion. Vous le listez dans la config ou l'ajoutez dans la console, et la page de connexion hébergée y est servie. Le domaine par défaut est auth.foir.io. Quand le domaine de connexion partage un domaine enregistrable avec votre app, le cookie de session de Fóir est first-party pour lui, ce qu'exigent les flux de session par cookie pour les applications monopages et rendues côté serveur.

Vérifier un nom d'hôte

L'enregistrement affiche deux enregistrements DNS : un CNAME qui pointe votre nom d'hôte vers l'edge de Fóir, et un enregistrement TXT qui porte un jeton de vérification. Dès que l'enregistrement TXT est trouvé, le domaine est vérifié. Le TLS est émis automatiquement à la première requête sur un domaine nouvellement vérifié, ce qui peut prendre un moment, puis il est renouvelé pour vous.

L'enregistrement ne réserve pas un nom d'hôte. Plusieurs projets peuvent détenir une revendication en attente, le premier à publier son enregistrement TXT devient l'unique propriétaire vérifié, et les revendications en attente sont effacées après sept jours.

Ce qu'un domaine personnalisé ne change pas

Un domaine d'API sert uniquement au routage. Chaque requête a toujours besoin de la clé du projet, et une requête dont le domaine appartient à un autre projet que sa clé est refusée. Les URL de fichiers et de médias ne passent pas sur votre domaine. Le nombre de domaines personnalisés dépend de votre forfait.

Lire le détail

La page des domaines d'API personnalisés couvre ce qui est servi sur votre domaine, les enregistrements DNS, la propriété du nom d'hôte et le dépannage.