Bounces API-documentatie

Welkom bij onze Bounces API documentatie. Als je meer informatie nodig hebt over deze API, raden we je aan onze API FAQ pagina te bezoeken. Onze API is ontworpen om je eenvoudig e-mails te laten verzenden en ontvangen, en we werken voortdurend aan het verbeteren en bijwerken van onze services om beter aan de behoeften van onze gebruikers te voldoen. Of je nu een ontwikkelaar bent die e-mailfunctionaliteit in je applicatie wil integreren of een bedrijf dat zijn e-mailcommunicatie wil stroomlijnen, onze API kan je helpen je doelen te bereiken.

Bounces treden op wanneer een e-mail wordt teruggestuurd naar de afzender omdat deze niet kan worden afgeleverd bij de ontvanger. Met deze API kun je deze bounce-events ophalen en analyseren om beter te begrijpen waarom e-mails niet worden afgeleverd.

Harde stuiters terughalen

Om hard bounces op te halen uit Inboxroad, doe je een GET verzoek naar https://api.inboxroad.com/api/v2/bounces met de juiste Bearer-Token en Content-Type: application/JSON.

curl -H ‘Authorization: Token  {{ TOKEN }}’
curl -H ‘Content-Type:application/json’ https://api.inboxroad.com/api/v2/bounces

* Je hebt je API token ontvangen tijdens je set-up bij inboxroad. Zo niet, neem dan contact op met je accountmanager.

{
     'uuid”: Unique identifier,
     “timelogged”: Unix timestamp,
     “bounce_type”:  ‘s’ for soft,
                         ‘h’ for hard,
                         ‘e’ for message expired,
     “rcpt”: recipient (RCPT TO: ) being reported,
     “orig”: originator (from MAIL FROM: ),
     “dsndiag”: DSN diagnostic string for the recipient to which it refers,
     “bouncecat”: likely category of the bounce,
     “header_from”: from header (of original email, complaints),
 }

Velden in JSON-antwoord

Het antwoord zal in JSON formaat zijn en de volgende velden bevatten:

  • uuid: Uniek identificatienummer
  • timelogged: Unix tijdstempel
  • bounce_type: ‘s’ voor zacht, ‘h’ voor hard, ‘e’ voor vervallen bericht
  • rcpt: Ontvanger (RCPT TO:) wordt gerapporteerd
  • orig: Afzender (van MAIL FROM:)
  • dsndiag: DSN-diagnostische string voor de ontvanger waarnaar wordt verwezen
  • bouncecat: Waarschijnlijke categorie van de bounce
  • header_from: Van header (van oorspronkelijke e-mail, klachten)

Query parameters voor bounce-oproepen

De volgende queryparameters kunnen worden gebruikt voor bounce-oproepen:

  • last_id: [UUID of the last record] – Retourneert alle logboeken na het opgegeven record.
  • order: [asc/desc] – Bepaalt of records in oplopende of aflopende volgorde worden geretourneerd.

Bijvoorbeeld:

Get request
curl -H ‘Authorization: Token  {{ TOKEN }}’
curl -H ‘Content-Type:application/json’ https://api.inboxroad.com/api/v/bounces?last_id=ce95fca7-b028-4f5c-810c-8bddeda4cac6&order=asc

Problemen met e-mailaflevering gemakkelijk begrijpen

De Bounces API is een essentieel hulpmiddel voor elke gebruiker die beter wil begrijpen waarom e-mails niet worden afgeleverd. Met de mogelijkheid om hard bounces op te halen en te analyseren, kunt u eenvoudig problemen oplossen en ervoor zorgen dat uw e-mails zonder problemen worden verzonden. Als je meer informatie nodig hebt of vragen over onze API, aarzel dan niet om contact op te nemen met ons ondersteuningsteam.