Accountmaker Docs
Types

Domaine

Configuration de domaine personnalisé pour le branding, l'envoi d'email et la gestion TLS.

domain dns tls email

Domaine

Un Domaine représente un hostname personnalisé enregistré sur un compte pour le branding, la délivrabilité email et la configuration TLS.

Schéma

interface Domain {
  id: string; // "hst..." - Identifiant unique
  account_id: string; // Compte propriétaire
  hostname: string; // Nom de domaine
  client_id: string | null; // Client associé
  cname_config: { type: "proxy" } | null;
  email_config:
    | { type: "catch-all" }
    | { type: "forward"; forward_to: Record<string, string> }
    | null;
  txt_verification_token: string; // Valeur TXT de vérification DNS
}

Propriétés

PropriétéTypeDescription
idstringKSUID avec préfixe hst
account_idstringCompte propriétaire du domaine
hostnamestringNom de domaine (ex. mail.example.com)
client_idstring?Client OAuth associé
cname_configobject?Configuration du proxy CNAME
email_configobject?Routage d’email entrant
txt_verification_tokenstringJeton de vérification DNS TXT

Vérification DNS

Ajoutez un enregistrement TXT pour vérifier la propriété :

TypeNomValeur
TXT_am.mail.example.com{txt_verification_token}

Flux de vérification

DNSSystemAdminDNSSystemAdminEnregistrer le domaineJeton TXT de vérificationAjouter l'enregistrement TXTPOST /api/domains/:domain_id/checksInterroger le TXTJeton trouvéMarquer comme vérifié

Exemple

{
  "id": "hst_2kHfPZcN9xW4mE8RtY7vB",
  "account_id": "acc_1jGePYbM8wV3lD7QsX6uA",
  "hostname": "mail.example.com",
  "client_id": null,
  "cname_config": { "type": "proxy" },
  "email_config": null,
  "txt_verification_token": "am_2abc123xyz"
}

Liens associés