Récupérer l'adresse de l'application web
L'adresse de l'application web de l'espace de travail, si l'on peut s'y connecter, et l'enregistrement CNAME dont elle a besoin. Quand aucune n'est définie, `status` vaut `none` et `domains` liste les domaines sous lesquels on peut en placer une.
Exécute le véritable appel sur votre espace de travail.
GET /app-host
L'adresse de l'application web de l'espace de travail, si l'on peut s'y connecter, et l'enregistrement CNAME dont elle a besoin. Quand aucune n'est définie, status vaut none et domains liste les domaines sous lesquels on peut en placer une.
Ce qu'est l'adresse de l'application web
export OE=https://api.openemail.ukexport AUTH="Authorization: Bearer $OPENEMAIL_API_KEY"Un espace de travail sur une offre payante peut ouvrir l'application web sur un sous-domaine de l'un de ses domaines vérifiés, comme mailbox.acme.com, ainsi que sur openemail.uk. C'est l'adresse que définit l'onglet Application à votre marque des paramètres Apparence de l'espace de travail, et un espace de travail en a une au plus.
Seuls les membres de l'espace de travail, les personnes qui se connectent avec l'une de ses adresses et toute personne ayant une invitation en attente peuvent s'y connecter, et eux seuls reçoivent depuis cette adresse les e-mails de réinitialisation du mot de passe et de vérification. Elle ressemble à openemail.uk jusqu'à ce que l'espace de travail définisse un logo sur sa page Apparence, puis elle affiche le logo, le symbole et le nom de l'espace de travail à la place des nôtres. Dès lors, les e-mails qu'OpenEmail leur envoie portent la marque, renvoient vers l'adresse et proviennent de noreply@ son domaine une fois les enregistrements de signature de ce domaine vérifiés.
Elle nécessite un enregistrement CNAME, que record détaille. L'adresse reste pending jusqu'à ce que l'enregistrement réponde et que son certificat soit délivré, puis passe à active. Avec l'offre gratuite, elle est conservée mais mise en pause : paused vaut true et personne ne peut s'y connecter jusqu'à ce que l'espace de travail repasse à une offre payante.
Exemple
Nécessite domains:read.
curl "$OE/app-host" -H "$AUTH"{ "object": "app_host", "id": "ahost_3f9c2a71d0b84e56a1c7f2e9", "host": "mailbox.acme.com", "domainId": "b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f", "domain": "acme.com", "status": "active", "active": true, "paused": false, "target": "cname.openemail.uk", "record": { "type": "CNAME", "name": "mailbox.acme.com", "value": "cname.openemail.uk" }, "error": null, "checkedAt": "2026-10-01T09:12:30.000Z", "verifiedAt": "2026-10-01T09:04:11.000Z", "available": true, "paidPlan": true, "domains": ["acme.com"], "suggested": "mailbox.acme.com"}Une lecture revérifie l'adresse quand sa dernière vérification date de plus de 15 secondes, donc interroger cette route régulièrement est la façon d'attendre que active passe à true.
active ne vaut true que quand status vaut active et que l'espace de travail est sur une offre payante. paused vaut true quand une adresse est définie et que l'espace de travail est sur l'offre gratuite.