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.

In 5 minuten geïntegreerd

Voordelen voor ontwikkelaars

Automatisch brieven versturen

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

Gratis API

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

Krachtige SDK's (binnenkort beschikbaar)

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

Ondersteunde betalingssystemen

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

Van ontwikkelaars voor ontwikkelaars

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

Track & Trace

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

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.v2.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.v2.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.v2.pingen.com/file-upload'
url_letters = 'https://api.v2.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)
})

Volledige API-documentatie

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

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.

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.

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.

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.

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. 🚀

PHP Library

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.