| Sommaire |
|---|
...
Authentification
Les paramètres d’authentifications doivent être fournis pour chaque appel à l’API.
Paramètres
| Nom | Description |
|---|---|
| method | La méthode de l'API que vous voulez appeler |
| apikey | Votre clé d'API |
| username | Votre nom d'usager (le même que pour votre login a PUBLITRAC*)
*Notez que nous pouvons vous créer un usager pour l'usage de l'API seulement |
| mot de passe | Votre mot de passe (le même que pour votre login a PUBLITRAC) |
Syntaxe
https://app.publitrac.com/api?method=[Nom de méthode]&apikey=[Votre clé API]&username=[Votre usager]&password=[Votre mot de passe]
Exemples
https://app.publitrac.com/api?method=getLeads&apikey=1234e567-890c-123e-4567-8901b234c56&username=MyUser&password=MyPassw0rd
Clé d'API
Votre clé d'API se trouve dans la section configuration dans l'onglet "Information du compte"
Limitation
Les appels à l’API doivent être limités à 50 par seconde.
Champ du lead
Pour connaitre les champs du lead, veuillez consulter la Liste et description des champs du lead.
Format
Toutes les dates envoyées avec l’API de PUBLITRAC doivent être du format « yyyy-mm-dd ».
Si le champ doit aussi comprendre le temps, le format devra être « yyyy-mm-dd hh:ii:ss ». Exemple : 2014-01-28 02:04:01.
Structure XML
Les paramètres de la requête doivent être codés correctement sinon ils seront rejeté par l'API
Afin de vous assurer que les paramètres XML de la requête sont codés correctement, il est recommandé de valider à l’aide d’un outil tel que : http://www.w3schools.com/xml/xml_validator.asp
Index des méthodes
Get leads
Effectuer une recherche de leads.
Url | |
Supported | GET |
Méthode | getLeads |
Paramètres obligatoires | method : getLeads apiKey : Vôtre clef API username : Votre nom d’usager password : Votre mot de passe query : La représentation de votre requête de recherche. |
Paramètres facultatifs | page : Page id (defaut est 1) |
Remarques | Les champs personnalisés sont affichés comme des champs leads réguliers. La représentation d’une requête XML est décrite à la fin de ce document. |
Exemples
| Bloc de code | ||||
|---|---|---|---|---|
| ||||
<?xml version="1.0" encoding="UTF-8"?>
<request>
<queries>
<query>
<field>firstName</field>
<operator>like</operator>
<value>john</value>
</query>
<query>
<field>lastName</field>
<operator>like</operator>
<value>smith</value>
</query>
<query>
<field>email</field>
<operator>like</operator>
<value>johnsmith@%</value>
</query>
</queries>
</request> |
| Bloc de code | ||||
|---|---|---|---|---|
| ||||
<response>
<leads>
<lead>
<id>470</id>
<firstName>John</firstName>
<lastName>Smith</lastName>
<middleName></middleName>
<company>PUBLIPAGE</company>
<phone>555-555-2149</phone>
<email>johnsmith@publipage.com</email>
<mailingAddress></mailingAddress>
<originalSource>Google</originalSource>
<originalSourceType>Organic Search</originalSourceType>
<keyword>marketing automation</keyword>
<jobTitle></jobTitle>
<dateOfBirth></dateOfBirth>
<status>Active</status>
<score>0</score>
<postalCode></postalCode>
<country></country>
<city></city>
<state></state>
<doNotCall>0</doNotCall>
<doNotCallReason></doNotCallReason>
<token>_nl-publipage.com-1282527313351-84730</token>
<unsubscribed>0</unsubscribed>
<unsubscribeCause></unsubscribeCause>
<fax></fax>
<mobile></mobile>
<isCustomer>0</isCustomer>
<isAnonymous>0</isAnonymous>
<emailInvalid>0</emailInvalid>
<emailInvalidCause></emailInvalidCause>
<notes></notes>
<suspended>0</suspended>
<suspendedReason></suspendedReason>
<blacklisted>0</blacklisted>
<blacklistedCause></blacklistedCause>
<customerId></customerId>
<website></website>
<language></language>
<nbrEmployees></nbrEmployees>
<revenue></revenue>
<crmLeadId>5564344</crmLeadId>
<createdDate>2015-08-23 01:35:13</createdDate>
<lastUpdated>2015-10-25 02:20:06</lastUpdated>
<someCustomField>my custom field</someCustomField>
</lead>
</leads>
<paging>
<page>1</page>
<items>1</items>
<offset>100</offset>
<total>1</total>
</paging>
<status>2001</status>
<message>Get leads success.</message>
</response> |
...
Add fill out form history
Ajouter un formulaire soumis à un lead existant.
|
|
Url | |
Supported | POST |
Méthode | addFillFormHistory |
Paramètres obligatoires | method : addFillFormHistory apiKey : Vôtre clef API username : Votre nom d’usager password : Votre mot de passe email: L’adresse courriel du lead. query: L’information du formulaire soumis. |
Paramètres facultatifs |
|
Remarques | Le nom du formulaire (formName) doit être un formulaire valide dans PUBLITRAC. |
Le courriel du lead doit contenir moins de 50 caractères |
Exemple
| Bloc de code | ||||
|---|---|---|---|---|
| ||||
<?xml version="1.0" encoding=" UTF-8"?>
<request>
<fillformleadhistory>
<information>Registration Form</information>
<context></context>
<formName>Infolettre</formName>
<url>/infolettre.php</url>
<values>
<![CDATA[
Firstname: Claude
Lastname: Sage
Email: claude@sage.com
Phone: 555-666-7777
]]>
</values>
<sessionId>2192c0f3802f8e0744e9940788121624</sessionId>
</fillformleadhistory>
</request> |
| Bloc de code | ||||
|---|---|---|---|---|
| ||||
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>3004</status>
<message>Add fill form history success.</message>
</response> |
...