Domínios personalizados

Um projeto pode servir sua API a partir de um domínio que você verifica, e um app de login pode servir a página de login hospedada a partir de um. Ambos são opcionais, e cada um tem um padrão do Fóir até você configurá-lo.

Um domínio de API para um projeto

Registre um hostname no console em Settings, depois API domains. Depois de verificado, a API do projeto responde ali como responde no padrão api.foir.dev. O seu domínio serve consultas e subscriptions GraphQL, o endpoint do schema usado para geração de código e os endpoints de upload de arquivos. Cache, limites de taxa e erros são os mesmos nos dois hostnames.

Um domínio de login para um app de login

Um domínio de login pertence a um app de login. Você o lista em config ou o adiciona no console, e o login hospedado é servido ali. O padrão é auth.foir.io. Quando o domínio de login compartilha um domínio registrável com o seu app, o cookie de sessão do Fóir passa a ser first-party nele, o que os fluxos de cookie de sessão para apps de página única e renderizados no servidor exigem.

Verificando um hostname

Ao registrar, aparecem dois registros DNS: um CNAME que aponta o seu hostname para a edge do Fóir e um registro TXT que carrega um token de verificação. Quando o registro TXT é encontrado, o domínio fica verificado. O TLS é emitido automaticamente na primeira requisição a um domínio recém-verificado, o que pode levar um instante, e é renovado para você.

Registrar não reserva um hostname. Vários projetos podem ter uma reivindicação pendente, o primeiro a publicar o seu registro TXT se torna o único dono verificado, e as reivindicações pendentes são apagadas após sete dias.

O que um domínio personalizado não muda

Um domínio de API é apenas roteamento. Toda requisição ainda precisa da chave do projeto, e uma requisição cujo domínio pertence a um projeto diferente do da sua chave é recusada. Os URLs de arquivos e mídia não passam para o seu domínio. O número de domínios personalizados depende do seu plano.

Leia os detalhes

A página de domínios de API personalizados cobre o que é servido no seu domínio, os registros DNS, a propriedade do hostname e a solução de problemas.