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

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.

Merci pour vos commentaires !

Nous nous efforçons en permanence d'améliorer la qualité de notre documentation et vos commentaires nous sont précieux. Veuillez sélectionner la ou les raisons de vos commentaires ou fournir des informations supplémentaires sur la façon dont nous pouvons nous améliorer :

Envoi de vos commentaires...
🎉 Merci pour vos commentaires !
Une erreur s'est produite. Veuillez réessayer.

Merci pour vos commentaires !

Recommandez-nous et gagnez $10 en 3 étapes simples !

Étape 1

Obtenir le lien

Obtenez un lien de recommandation personnel gratuit ici

Étape 2

Donner $10

Votre utilisateur s'inscrit et effectue la mise à niveau en utilisant le lien

Étape 3

Obtenir $10

1 250 SMS gratuits
OU 1 000 minutes vocales gratuites
OU 12 000 chats
OU plus