API

Contactpersoon wijzigen

Dit voorbeeld zal een overzicht van alle in MailCamp aangemaakte mailinglijsten weergeven in een XML met de gevonden data.

Parameters

Parameters
VeldTypeOmschrijvingVerplicht / Optioneel
usernamestring

De gebruikersnaam wordt gebruikt om in te loggen op de MailCamp.

Verplicht
usertokenstring

De unieke token toegewezen aan de hierboven genoemde gebruiker.

Verplicht
requesttypestring

De naam van het betreffende API-bestand.

Verplicht
requestmethodstring

De naam van de functie die wordt aangeroepen.

Verplicht
responsetypestring

Het format van de response. Dit kan zijn 'xml' of 'json'.

Optioneel
details

Zie de velden hieronder.

Verplicht
emailaddressstring

Het e-mailadres van de contactpersoon die wordt toegevoegd.

Verplicht
mailinglistidint

De mailinglijst waarin de contactpersoon staat.

Verplicht
mailinglistid.subscribedateint

Vul de inschrijfdatum in als unix timestamp.

Optioneel
mailinglistid.lastopenint

Vul de datum 'laatst geopende nieuwsbrief' in als unix timestamp.

Optioneel
fieldidint

Het ID van het extra veld dat dient te worden toegevoegd.

Verplicht
valuestring

De waarde die aan het extra veld moet worden toegekend. In het geval van een checkbox kunnen het meerdere values zijn. Let erop dat indien een value een &-teken heeft dat er CDATA en urlencoding() gebruikt moet worden.

Verplicht
tagidint

Het ID van de tag die dient te worden toegevoegd.

Optioneel
tagnamestring

De naam van de tag die dient te worden toegevoegd.

Optioneel

Succesvolle response

Succesvolle response
VeldTypeOmschrijving
statusstring

De waarde van het status-veld wordt als “SUCCESS” teruggeven bij een succesvolle respons.

data

Indien de statistieken worden gevonden wordt het object teruggegeven.

Request voorbeeld
<xmlrequest>
	<username>admin</username>
	<usertoken>0123456789abcdef0123456789abcdef01234567</usertoken>
	<requesttype>subscribers</requesttype>
	<requestmethod>EditSubscriberCustomFields</requestmethod>
	<responsetype>xml</responsetype>
	<details>
		<mailinglist>99</mailinglist>
		<contact>
			<emailaddress>email@mailcamp.nl</emailaddress>
			<subscribedate>1483228800</subscribedate>
			<lastopen>1483228800</lastopen>
			<customfields>
				<item>
					<fieldid>99</fieldid>
					<value>Jan Jansen</value>
				</item>
				<item>
					<fieldid>99</fieldid>
					<value><![CDATA[Eten %26 Drinken]]></value>
					<value><![CDATA[Sport]]></value>
					<value>Jan Jansen</value>
				</item>
				<item>
					<fieldid>99</fieldid>
					<value>31/01/1980</value>
				</item>
			</customfields>
			<tags>
				<tagid>99</tagid>
				<tagid>99</tagid>
				<tagname><![CDATA[Prospect]]></tagname>
				<tagname><![CDATA[Lead]]></tagname>
			</tags>
		</contact>
	</details>
</xmlrequest>