API
Tags koppelen
Dit voorbeeld laat zien hoe tags aan een contactpersoon kunnen worden gekoppeld.
Parameters
| Veld | Type | Omschrijving | Verplicht / Optioneel |
|---|---|---|---|
username | string | De gebruikersnaam wordt gebruikt om in te loggen op de MailCamp. | Verplicht |
usertoken | string | De unieke token toegewezen aan de hierboven genoemde gebruiker. | Verplicht |
requesttype | string | De naam van het betreffende API-bestand. | Verplicht |
requestmethod | string | De naam van de functie die wordt aangeroepen. | Verplicht |
responsetype | string | Het format van de response. Dit kan zijn 'xml' of 'json'. | Optioneel |
details | Zie de velden hieronder. | Verplicht | |
subscriberid | int | Dit is een verplicht veld tenzij je het e-mailadres en de listid meegeeft in de call. Het ID van de contactpersoon waaraan de tags moeten worden toegevoegd. Dit ID kun je ophalen met de requestmethode 'IsSubscriberOnList'. | Optioneel |
listid | int | Dit is een verplicht veld tenzij je de subscriberid meegeeft in de call. Het ID van de mailinglijst waar de contactpersoon op staat waaraan de tags moeten worden toegevoegd. | Optioneel |
emailadress | string | Dit is een verplicht veld tenzij je de subscriberid meegeeft in de call. Het e-mailadres van de contactpersoon waaraan de tags moeten worden toegevoegd. | Optioneel |
tags | string | Geef hier de ID's van de tags op komma-gescheiden. | Verplicht |
Succesvolle response
| Veld | Type | Omschrijving |
|---|---|---|
status | string | De waarde van het status-veld wordt als “SUCCESS” teruggeven bij een succesvolle respons. |
data | Indien de statistieken worden gevonden wordt het object teruggegeven. |
Foutmelding
| Veld | Type | Omschrijving |
|---|---|---|
status | string | De waarde van het status-veld zal “FAILED” zijn. |
errormessage | string | Een tekstuele boodschap om uit te leggen waarom het verzoek is mislukt. |
<xmlrequest>
<username>admin</username>
<usertoken>0123456789abcdef0123456789abcdef01234567</usertoken>
<requesttype>subscribers</requesttype>
<requestmethod>SaveSubscriberTags</requestmethod>
<responsetype>xml</responsetype>
<details>
<subscriberid>9999</subscriberid>
<listid>9999</listid>
<emailaddress>email@mailcamp.nl</emailaddress>
<tags>1,2,3,4</tags>
</details>
</xmlrequest>