Recevoir des e-mails

Lisez vos e-mails avec l'API

Lisez les e-mails qui arrivent sur votre domaine depuis votre propre code. Listez les conversations, ouvrez les messages, recherchez, libellez, organisez, envoyez et répondez, le tout via un seul endpoint.

  • REST
  • JSON
  • Fils et recherche
  • Libellés et dossiers
  • Envoyer et répondre
Hôtehttps://g.sendcorex.com

Fonctionnement

Un token, une boîte aux lettres

Votre token appartient à un expéditeur, et un expéditeur est une boîte aux lettres. Aucun argument ne choisit les e-mails de qui vous lisez : c'est le token qui décide.

Un endpoint pour tout

Lister, lire, rechercher, marquer, déplacer, envoyer et répondre sont des commandes envoyées à POST /v1. Envoyez-en jusqu'à 20 par requête.

Tokens à durée de vie courte

L'access token est valable 1 heure et le refresh token 15 jours. Le refresh token change à chaque utilisation.

Configurez votre boîte aux lettres

À faire une seule fois. Ensuite, chaque requête n'a besoin que de votre token.

  1. 1

    Ajoutez un domaine ou utilisez un domaine partagé

    Vérifiez votre propre domaine, ou évitez la configuration DNS en utilisant un domaine partagé.

  2. 2

    Créez un expéditeur

    Un expéditeur est une boîte aux lettres. Créez-en un sur votre domaine vérifié ou sur un domaine partagé : sur un domaine partagé, créer l'expéditeur crée la boîte aux lettres.

    Si vous avez enregistré votre propre domaine et déjà envoyé un e-mail, l'expéditeur a été créé automatiquement pour vous.

  3. 3

    Pointez votre enregistrement MX

    Nécessaire uniquement si vous voulez recevoir des e-mails sur votre propre domaine. Pointez l'enregistrement MX vers l'hôte entrant de Sendcorex.

  4. 4

    Générez vos tokens

    Ouvrez le webmail, allez dans Paramètres et générez un access token et un refresh token pour l'expéditeur.

  5. 5

    Appelez l'API

    Envoyez votre token dans le header Authorization et votre première commande à POST /v1.

Enregistrement MX

Pour recevoir des e-mails sur votre propre domaine, son enregistrement MX doit pointer vers l'hôte entrant de Sendcorex. Ajoutez cet enregistrement chez votre fournisseur DNS.

  • TypeMX
  • Pointe versbounce.emailsbit.com
i

L'enregistrement MX ne sert qu'à recevoir sur votre propre domaine. Sans lui, vous pouvez toujours envoyer, et lire les bounces et les plaintes qui reviennent dans votre boîte aux lettres.

Ce qui arrive dans la boîte aux lettres

E-mails ordinaires

Tout ce qui est envoyé à l'adresse de votre expéditeur, comme dans n'importe quelle boîte aux lettres.

Messages du return path

Les bounces et autres messages qui reviennent au return path sont aussi enregistrés dans la boîte aux lettres, vous pouvez donc les lire via l'API.

Plaintes

Les plaintes pour spam sont aussi enregistrées dans la boîte aux lettres. Elles ne proviennent que de Microsoft 365 et des services Microsoft en général.

Votre première requête

Listez les conversations non lues de votre INBOX. Remplacez SENDCOREX_TOKEN par l'access token des paramètres du webmail.

curl -X POST 'https://g.sendcorex.com/v1' \
  -H "Authorization: $SENDCOREX_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
  "commands": [
    { "command": "list_threads", "args": { "folder": "INBOX", "is_read": false, "limit": 10 } }
  ]
}'

Chaque fil a un last_message_uid. Passez-le à Obtenir des messages pour lire l'e-mail, ou à Répondre pour y répondre.

Référence complète

Tout ce qui est marqué CMD est une commande envoyée via POST /v1, jusqu'à 20 par requête. Les routes utilisent leurs propres chemins.

Routes

4

Identité

1

Dossiers et compteurs

5

Lecture

5

Indicateurs et libellés

8

Organiser

4

Envoi et confiance

9

Pièces jointes

4

Programmation

3

Brouillons

5

Règles

10

Templates

6

Contact et relance

5

Contacts et audience

12

Newsletters

4