You are viewing the French site, but your language preference is set to English. Switch to English site →
Rate this page:

Commencer avec l'API SendGrid

Il existe plusieurs façons de commencer avec l'API SendGrid.

Prérequis pour envoyer votre premier e-mail avec l'API SendGrid

Ces instructions décrivent comment envoyer votre premier e-mail à l'aide des appels cURL. C'est l'une des nombreuses façons d'envoyer des e-mails avec l'API SendGrid, car nous avons également des librairies PHP, Python, Node.js, Java, C#, Go et Ruby.

Avant de commencer à utiliser l'API, vous devez procéder comme suit :

  1. Créez un [compte] SendGrid(https://sendgrid.com/pricing/).
  2. Créez une clé API.
  3. Assurez-vous que curl est installé sur votre machine.

cURL est fourni de série sur les systèmes d'exploitation Mac.

Comment envoyer un e-mail API

Construisez votre appel API

Votre appel API doit avoir les composants suivants :

  • Un hôte. L'hôte des requêtes API Web v3 est toujours https://api.sendgrid.com/v3/
  • Un en-tête d'autorisation. Une clé API doit être incluse dans l'en-tête d'autorisation.
  • Une requête. Lors de la soumission de données à une ressource via POST ou PUT, vous devez soumettre votre charge utile dans JSON.

Limite de taille du message : La taille totale du message ne doit pas dépasser 20 Mo. Cela inclut le message lui-même, les en-têtes et la taille combinée des pièces jointes.

Notez que l'authentification de base n'est plus acceptée ; vous devez utiliser une clé API.

Pour envoyer un e-mail à l'aide de l'API SendGrid :

curl --request POST \
--url https://api.sendgrid.com/v3/mail/send \
--header 'Authorization: Bearer <<YOUR_API_KEY>>' \
--header 'Content-Type: application/json' \
--data '{"personalizations":[{"to":[{"email":"john.doe@example.com","name":"John Doe"}],"subject":"Hello, World!"}],"content": [{"type": "text/plain", "value": "Heya!"}],"from":{"email":"sam.smith@example.com","name":"Sam Smith"},"reply_to":{"email":"sam.smith@example.com","name":"Sam Smith"}}'
  1. Copiez l'exemple curl ci-dessus.
  2. Collez l'appel curl dans votre éditeur de texte favori.
  3. Copiez votre clé API et collez-la dans l'en-tête "Authorization" (Autorisation).
  4. Dans la section Données, spécifiez les noms et adresses e-mail "to" (À), "from" (De) et "reply to" (Répondre), puis saisissez un objet.
  5. Copiez le code et collez-le dans votre terminal.
  6. Appuyez sur Entrée.
  7. Vérifiez la boîte de réception de l'adresse que vous avez spécifiée comme adresse e-mail "to" (À) et découvrez votre message !

Si vous n'avez pas encore configuré l'Authentification de l'expéditeur dans votre compte, vous devrez peut-être consulter votre dossier de courrier indésirable pour trouver l'e-mail que vous venez d'envoyer.

Messages de réponse API

Toutes les réponses sont renvoyées au format JSON. Nous le spécifions en envoyant l'en-tête Content-Type. L'API Web v3 propose une sélection d'options de codes de réponse, d'en-têtes de type de contenu et de pagination pour vous aider à interpréter les réponses à vos requêtes API.

Bénéficiez d'une assistance d'intégration supplémentaire. Gagnez du temps, améliorez la qualité de votre envoi et garantissez votre réussite à long terme avec les services d'intégration SendGrid.

Étapes suivantes

Pour plus d'informations sur SendGrid et pour savoir ce que vous pouvez faire ensuite, consultez les pages suivantes :

Rate this page:

Besoin d'aide ?

Ça arrive à tout le monde, il est parfois difficile de coder. Obtenez de l'aide dès maintenant auprès de notre support team, ou appuyez-vous sur la sagesse collective en parcourant SendGrid tag sur Stack Overflow.

        
        
        

        Thank you for your feedback!

        We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

        Sending your feedback...
        🎉 Thank you for your feedback!
        Something went wrong. Please try again.

        Thanks for your feedback!

        Refer us and get $10 in 3 simple steps!

        Step 1

        Get link

        Get a free personal referral link here

        Step 2

        Give $10

        Your user signs up and upgrade using link

        Step 3

        Get $10

        1,250 free SMSes
        OR 1,000 free voice mins
        OR 12,000 chats
        OR more