API om brieven via DHL te verzenden

De krachtige, volledig aan te passen Post API van Pingen is jouw softwaretoepassing om brieven via DHL te versturen. Onze SDK's zorgen voor een snelle en eenvoudige integratie.

API om brieven via DHL te verzenden
Voordelen voor ontwikkelaars

Automatisch brieven versturen

De Post API van Pingen maakt eenvoudige software-integraties mogelijk, om zo automatisch brieven via DHL te versturen.

Brief API

Gratis API

We helpen je graag bij het automatiseren van processen. Daarom is onze API gratis voor alle klanten.

Krachtige SDK's

Krachtige SDK's (binnenkort beschikbaar)

Verstuur brieven in recordtijd via DHL met onze SDK's voor PHP, Java, C# en .Net.

Ondersteunde betalingssystemen

Ondersteunde betalingssystemen

Automatische afdruk als Zwitserse QR-factuur of met SEPA-overschrijvingsformulieren in Duitsland en Oostenrijk.

Post API van ontwikkelaars voor ontwikkelaars

Van ontwikkelaars voor ontwikkelaars

Alle functies van Pingen zijn ook beschikbaar via onze Post API en worden gedetailleerd uitgelegd in onze documentatie.

Track & Trace

Track & Trace

Pingen biedt gedetailleerde statusinformatie en realtime voortgangsupdates voor elke brief die via de API wordt verzonden.

Genereer inkomsten

Genereer inkomsten

Bedrijven die het versturen van brieven integreren en doorverkopen, hebben een mooie nieuwe kans om extra inkomsten te genereren.

Dit is hoe eenvoudig onze API werkt

De Brief API van Pingen is ontworpen om flexibel en eenvoudig te zijn, waardoor het makkelijk en snel te integreren is. Naast de gebruiksvriendelijke documentatie bieden we ook codevoorbeelden waarmee je snel aan de slag kunt.

curl \
       -X GET "https://api.pingen.com/file-upload" \
       -H "Authorization: Bearer INSERT_YOUR_ACCESS_TOKEN_HERE"

# Extract data.attributes.url and data.attributes.url_signature from response

curl -X PUT -T path_to_your_file.pdf "INSERT_URL_FROM_INITIAL_CURL_REQUEST"

curl \
       -X POST "https://api.pingen.com/organisations/YOUR_ORGANISATION_UUID/letters" \
       -H "Content-Type: application/vnd.api+json" \
       -H "Authorization: Bearer INSERT_YOUR_ACCESS_TOKEN_HERE" \
       --data-binary @- << EOF
       {
           "data": { \
               "type": "letters", \
               "attributes": { \
                   "file_original_name": "your_filename.pdf", \
                   "file_url": "INSERT_URL_FROM_INITIAL_CURL_REQUEST", \
                   "file_url_signature": "INSERT_URL_SIGNATURE_FROM_INITIAL_CURL_REQUEST", \
                   "address_position": "left", \
                   "auto_send": false, \
                   "delivery_product": "fast", \
                   "print_mode": "simplex", \
                   "print_spectrum": "color" \
               } \
       } \
   }
EOF

require __DIR__ . '/vendor/autoload.php';

$provider = new \Pingen\Provider\Pingen(
   array(
   'clientId' => 'YOUR_OAUTH2_CLIENT_ID',
   'clientSecret' => 'YOUR_OAUTH2_CLIENT_SECRET'
)
);

$access_token = $provider->getAccessToken('client_credentials');

$lettersEndpoint = (new \Pingen\Endpoints\LettersEndpoint($access_token))
    ->setOrganisationId('INSERT_YOUR_ORGANISATION_UUID_HERE');

$lettersEndpoint->uploadAndCreate(
   (new \Pingen\Endpoints\DataTransferObjects\Letter\LetterCreateAttributes())
       ->setFileOriginalName('your_original_pdf_name.pdf')
       ->setAddressPosition('left')
       ->setAutoSend(false),
   fopen('path_to_your_original_pdf_name.pdf', 'r')
);

import json
import requests

url_file_upload = 'https://api.pingen.com/file-upload'
url_letters = 'https://api.pingen.com/organisations/YOUR_ORGANISATION_UUID/letters'
access_token = 'INSERT_YOUR_ACCESS_TOKEN_HERE'

response = requests.get(url_file_upload, headers =
    'Authorization': 'Bearer {}'.format(access_token),
})
data = json.loads(response.text)['data']
file_url = data['attributes']['url']
file_url_signature = data['attributes']['url_signature']

file = open('path_to_your_file.pdf', 'rb')
requests.put(file_url, data=file)
file.close()

payload = {
    'data': {
         'type': 'letters',
         'attributes': {
              'file_original_name': 'your_filename.pdf',
              'file_url': file_url,
              'file_url_signature': file_url_signature,
              'address_position': 'left',
              'auto_send': False
         }
    }
}
requests.post(
    url_letters,
    json.dumps(payload),
    headers = {
         'Content-Type': 'application/vnd.api+json',
         'Authorization': 'Bearer {}'.format(access_token)
    })

API Highlights

De API voor brieven verzenden

Brieven versturen via de Post API van Pingen is net zo eenvoudig als het verzenden van een standaard e-mail. Onze API is digitaal en volledig aanpasbaar.

API Documentatie
Leer meer
Online briefpost
Automatische documentvalidatie

Pingen controleert automatisch alle ingediende PDF's in nakoming met de vereisten voor het versturen van brieven. Als niet aan de vereisten wordt voldaan, biedt Pingen opties om deze rechtstreeks via de API aan te passen.

Verstuur brieven geautomatiseerd
Digitale verwerking van retouren

Als Post brieven niet kan bezorgen, worden deze automatisch via de Pingen DMC opgevangen, gecontroleerd, vernietigd en via webhooks gerapporteerd. Op deze manier worden onbestelbare brieven altijd digitaal verwerkt.

Gedetailleerde Track & Trace
Sandbox / Testomgeving

Pingen biedt alle ontwikkelaars een testomgeving om ervoor te zorgen dat integraties eenvoudig en gemakkelijk in een sandbox kunnen worden getest. Alle functies van Pingen zijn beschikbaar in de sandbox, maar hier worden geen brieven verstuurd.

Verwerking van retourzendingen
Gedetailleerde prijscalculator

Gebruik het prijscalculator-eindpunt om de prijs van een brief vooraf te controleren. Op deze manier zie je altijd de volledige kosten, voordat je een brief verstuurt.

Webhooks

Ontvang real-time brief events met webhooks

Pingen biedt automatische meldingen voor belangrijke events via webhooks. U wordt bijvoorbeeld in real time gewaarschuwd wanneer een brief is verzonden, een probleem heeft of onbestelbaar is. Hierdoor kunt u automatisch verdere actie ondernemen zonder dat u actief onze API hoeft te "pollen" voor wijzigingen.

In het webhook management van Pingen kunt u voor elk verzoek gedetailleerde informatie bekijken, zoals de payload en het antwoord van uw systeem. Zo kunt u problemen snel opsporen en met weinig moeite oplossen.

Briefverzending in één overzicht
Pingen PHP Library

Met de Pingen PHP Library wordt het nog eenvoudiger

De Pingen PHP Library biedt alles wat je nodig hebt om onze API te integreren en brieven te versturen via Post. Pingen heeft het werk voor alle PHP-ontwikkelaars al gedaan. Binnenkort zullen we onze SDK's vrijgeven voor alle andere ontwikkelaars. 🚀

Meer dan alleen een API voor brieven

Onze Post API biedt veel meer dan de klassieke API die door brievenshops of mailserviceproviders wordt gebruikt. Met Pingen heb je toegang tot een snelgroeiende en internationale service waarmee je wereldwijd brieven kunt verzenden tegen de beste prijs.

Lokale post service aanbieder

Lokale post service aanbieder

Nu al worden brieven gedrukt en verstuurd in Nederland, Duitsland, Oostenrijk, Zwitserland en India.

Internationale postbezorging

Internationale postbezorging

Door ons partnerschap met DHL garandeert Pingen een snelle en betrouwbare levering naar alle andere landen via luchtpost.

Schaalbaar en betrouwbaar

Schaalbaar en betrouwbaar

Pingen is eenvoudig schaalbaar en veilig dankzij onze cloud- en multi-site briefdrukinfrastructuur.

Begin nu met ontwikkelen

Bekijk de documentatie van onze Post API en zie hoe eenvoudig het is om brieven via PostNL in jouw softwareoplossing te integreren!