API respons
Na het succesvol versturen van je request, stuurt SMTPeter een JSON object terug met daarin een unieke identifier voor elke ontvanger waar de e-mail naar verstuurd gaat worden.
{
"id1" : "recipient1@example.com",
"id2" : "recipient2@example.com"
}De geretourneerde id's kunnen worden gebruikt om informatie te verkrijgen middels andere methodes van de REST API. Omdat je e-mails kunt versturen naar meerdere ontvangers met slechts een call, bevat de geretourneerde waarde wellicht meerdere id's en recipients.
Afhandeling van fouten
De REST API heeft een heldere manier om fouten te communiceren. Namelijk,
het teruggeven van de reguliere HTTP error code
in kwestie. Het opgeven van verkeerde data of andere foutmeldingen maakt
niet uit, omdat je ook altijd een textuele uitleg terugkrijgt over wat
precies fout is gegaan. Een succesvolle call geeft je altijd een status
code terug van 200 tot en met 202.
