EN NL FR

INTEGREREN MET POSTBIRD ?

Volg onderstaande documentatie om de integratiemogelijkheden te ontdekken.

1. Introductie

Postbird is gebaseerd op het Ecerium Elements microservices platform en biedt een aantal verschillende manieren van integratie aan. Onderstaand document geeft een overzicht van de verschillende integratiemogelijkheden en details van elke mogelijkheid

2. Drie manieren van integratie

Momenteel bieden wij 3 manieren aan om te integreren met de Postbird applicatie. Hieronder vind je de use cases van elk.

Wie betaalt Integreer via Integratie complexiteit
Postbird klant Klant Desktop applicatie Laag
Api Integrator Account Integrator REST call Medium
E-mail Integrator Account Integrator E-Mail Laag

2.1 De Postbird Desktop applicatie gebruiken

Software die op de computer van de klant wordt uitgevoerd kan de mogelijkheid bieden om een PDF document op te slaan in de verwerkings directory van Postbird. De Postbird klant zal het PDF document ophalen en verwerken.

Vereisten

  • De software moet worden uitgevoerd op de computer van de klant
  • De klant moet de Postbird klant applicatie hebben geïnstalleerd
  • De Postbird klant applicatie moet uitgevoerd worden
  • Het verzenden van het document wordt beheerd door de gebruikersaccount van de klant en is afhankelijk van de voorziene balans van de account

Integratie complexiteit

Laag

2.2 De Postbird API gebruiken

Postbird heeft een API ontwikkeld (zie documentatie in het hoofdstuk over de API referentie) die kan gebruikt worden om te integreren met eender welke applicatie.


Een algemeen integratiescenario zou zijn dat u een Postbird account aanmaakt en dat uw applicatie deze account zal gebruiken. In dat geval moet u er altijd voor zorgen dat u voldoende geld op uw account voorziet. Uw klanten kunnen de diensten die uw applicatie aanbiedt gebruiken. En uw applicatie kan op zijn beurt ook Postbird gebruiken. Of, en hoeveel u aanrekent voor het gebruik van onze diensten valt volledig onder uw eigen verantwoordelijkheid.

Vereisten

  • U moet een Postbird account aanmaken en een applicatie definiëren
  • U moet een applicatie token aanmaken dat u kan gebruiken voor het communiceren met Postbird
  • U moet de API gebruiken om uw applicatie te integreren met Postbird

Integratie complexiteit

Medium

2.3 E-mail gebruiken met het account van de integrator

U kan simpelweg een Postbird account aanmaken en de e-mail feature inschakelen. U kan het specifieke e-mail adres gebruiken en het gebruiken als bestemmingsadres voor een e-mail met de bijgevoegde PDF (zie e-mail integratie verder in dit document).

Vereisten

  • U moet een Postbird account aanmaken en de e-mail feature inschakelen (de balans van dit Postbird account zal worden gebruikt)
  • Uw applicatie moet de PDF verzenden als bijlage naar dit e-mail adres

Integratie complexiteit

Laag

3 API Informatie

Vraag een integrator token aan op onze identity server en gebruik deze om met onze API te communiceren.

3.1 Live Swagger Documentatie

De swagger documentatie en uitleg over onze API vind je op https://api-prd2.postbird.be/swagger/ui/index

3.2 Connecteer via onze API

 

  • The first step

Go to our identity server (https://login-prd2.ecerium.be/Manage) and select integration Token.

  • The second step

Create a Token, select a name and enter your password for security reasons.


 

  • Almost there…

Make sure your token is now available in the Active Token section.

  • The Call:                                                                                             

POST 
https://api-prd2.postbird.be/integration/sendMyDocument
Content-Type: application/jsoncache-control: no-cache
Authorization: Bearer a626e76d73547c68555e969168f4bc3d1f08aac00a3233a14ca1c7692a6a79b5
Accept: */*
Host: api-prd2.postbird.be
accept-encoding: gzip, deflate
content-length: 55854
Connection: keep-alive

 
{

  "attachment": {

    "fileName": "string",

    "base64Content": "string"

  },

  "config": {

    "color": true,

    "rectoVerso": true,

    "registered": true,

    "selectedSendMethod": "overWriteAddressField",

    "address": {

      "recipientName": "Homer Simpson",

      "street": "Evergreen Terrace",

      "houseNumber": "742",

      "postcode": "65806",

      "city": "Springfield",

      "isoCountryCode": "BE"

    }

  }

}

Attachment section

filename:                                 the name of your pdf file (myLetter.pdf)

base64Content:                      the content of your pdf file (encoded as base64)

 

Config section

color:                                       document printed in color (true/false)

rectoVerso:                             document printed on both sides of a page (true/false)

registered:                              do you want your letter to be delivered

                                                 registered (true/false)

 

selectedSendMethod (optional)        

  1. normal (send letter as seen in pdf) ,
  2. addWhitePage (add a white cover page with the address printed on the correct position, this will cost you an extra page)
  3. overWriteAddressField (add a white textbox with the address provided on the correct position this will overwrite any text or image in that position)

 

Address Section (optional, unless selectedSendMethod is addWhitePage or overWriteAddressField)

 recipientName                    First and last name of recipient                         

 street                                   Street name

 houseNumber                    House number

 postcode                             Postal code

 city                                       City

 isoCountryCode                  Iso country code, two characters

                                                 (https://nl.wikipedia.org/wiki/ISO_3166-1)

 

  • API

If you want to check our documentation on our API: https://api-prd2.postbird.be/swagger/ui/index

3.3 Verstuur een brief via email (coming soon)

Gebruik de instellingen van je account om een mail account te configureren waarmee je een bijlage als fysieke brief kan versturen. Meer info volgt snel!