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 :
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"}}'
- Copiez l'exemple curl ci-dessus.
- Collez l'appel curl dans votre éditeur de texte favori.
- Copiez votre clé API et collez-la dans l'en-tête "Authorization" (Autorisation).
- 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.
- Copiez le code et collez-le dans votre terminal.
- Appuyez sur Entrée.
- 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.
Voulez-vous des conseils d'experts pour faire démarrer votre programme de messagerie sur le bon pied ?
Gagnez du temps et garantissez votre réussite à long terme avec l'implémentation de la messagerie. Nos experts travailleront comme une véritable extension de votre équipe et s'assureront que votre programme de messagerie est correctement configuré et qu'il offre de la valeur à votre entreprise.
SERVICES D'IMPLÉMENTATION →
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 :
Besoin d'aide ?
Ça arrive à tout le monde. Obtenez de l'aide dès maintenant auprès de l'Équipe d'assistance Twilio SendGrid.
Vous faites face à un problème de code ? Appuyez-vous sur la sagesse collective en parcourant le tag SendGrid sur Stack Overflow ou en visitant le collectif Stack Overflow de Twilio.
