Documentatie

Een fout gevonden?

Je kan deze pagina op GitHub vinden.

Een wijziging voorstellen

Python voorbeeld

In dit Python voorbeeld kun je zien hoe je een e-mail kunt versturen met de REST API.

Het voorbeeld laat een simpele class zien genaamd SMTPeter. De constructor van de class pakt je access token als input. Alleen de post() member function is geïmplementeerd met welke je een e-mail instructie kunt sturen naar SMTPeter.

import requests
import json
import pprint

class SMTPeter:

    # constructor
    def __init__(self, accesstoken):
        # Set token
        self.token = str(accesstoken)

    # post method
    def post(self, method, fields):
        # Create correct url
        url = "https://www.smtpeter.com/v1/" + method + "?access_token=" + self.token

        # Create JSON
        data_json = json.dumps(fields)

        # Set content type to JSON
        headers = {'Content-type': 'application/json'}

        # Make request and return response
        return requests.post(url, data=data_json, headers=headers)

Het gebruik van deze klasse is makkelijk. Na het opstellen van je bericht in JSON format ziet deze er bijvoorbeeld zo uit:

{
    "envelope"  : "sender@example.com",
    "recipient" : "receiver@example.com",
    "subject"   : "This is the mail subject",
    "from"      : "sender@example.com",
    "to"        : "receiver@example.com",
    "html"      : "<html><head><style>body { font-weight: 600; }</style></head><body>This is the html version.</body></html>",
    "text"      : "And this is the text version"
}

Je kunt de data vervolgens inladen met Python op de gewenste manier en deze versturen met het volgende script:

# jouw access token
token = "abcde"

# maak een SMTPeter connectie aan met jouw token
mySMTPeterConnection = SMTPeter(token)

# importeer hier je JSON data in een variabele genaamd 'data'

# gebruik de SMTPeter connectie om een POST methode aan 
# te roepen en geef de JSON data mee
response = mySMTPeterConnection.post("send", data)

# print de respons van de server in JSON format
pprint.pprint(response.json())

Als het verzoek succesvol is uitgevoerd is de API respons een array met message IDs en e-mailadressen.

Meer informatie