Voorbeeld JSON

JSON is een manier om gegevens gestructureerd door te geven aan een systeem, zoals Print.one. Mocht je nog niet bekend zijn met JSON, kan je het zien als een lijst met sleutels en waarden die aangeven welke informatie waar moet komen. Het is de manier waarop je gegevens naar Print.one stuurt, zodat je kaarten automatisch gepersonaliseerd kunnen worden

Toelichting gebruik JSON

Gebruik JSON om template ID, billing ID en merge variables mee te geven.

Template ID

Vervang 'tmpl_12345678900987654321' door de ID van de template die je wilt gebruiken. Het Template ID kun je vinden in de Print.one Portal. Ga links in het menu naar ‘Design templates’ en kopieer het Template ID naast de titel van het juiste ontwerp. 

Billing ID (optioneel)

Bij 'billingId' kun je een kenmerk invullen, bijvoorbeeld de naam van de campagne. Dit kenmerk zie je later terug in je overzichten en op de factuur.

Merge variables

Merge variables zijn de gegevens die je in je template wilt invullen. Komen op jouw kaart personalisaties te staan, zoals een voornaam of kortingscode? Dan moet je deze meesturen in de API.

Bijvoorbeeld: als je in je HTML {{firstname}} gebruikt, wordt deze variabele vervangen door de waarde die je in de JSON meestuurt bij de API call.

Let op: gebruik geen punten in de namen van merge variables.

Voor meer informatie en voorbeelden, zie de API-documentatie.

Voorbeeld JSON

JSON:
1{
2  "sender": {
3    "name": "Sender & Co. Ltd",
4    "address": "Street 123",
5    "postalCode": "1234AB",
6    "city": "Amsterdam",
7    "country": "Netherlands"
8  },
9  "recipient": {
10    "name":"Jane Doe",
11    "address":"Lane 321",
12    "postalCode":"4321CD",
13    "city": "The Hague",
14    "country": "Netherlands"
15  },
16  "mergeVariables": {
17    "firstname": "Jane",
18    "discount": "10%",
19    "couponcode": "DISCOUNT10"
20  },
21  "templateId": "tmpl_12345678900987654321",
22  "finish": "GLOSSY",
23  "billingId": "Attribute e.g. campaign name for cost allocation"
24}