API allogarage

Les développeurs qui souhaiteraient interagir avec le site allogarage peuvent maintenant utiliser la nouvelle API!

URL d’accès: http://www.allogarage.fr/v2/main/xmlrpc.php

3 fonctions simples sont accessibles via XMLRPC:

struct getGarage(int id)

permet de recuperer un garage a partir de son identifiant (id dans la base allogarage).

Exemple:

Paramètres d’appel:

<param>
<value><int>1345</int></value>
</param>
Retour:

<methodResponse>
<params>
<param>
<value><struct>
<member><name>id</name>
<value><string>1345</string></value>
</member>
<member><name>telephone</name>
<value><string>04 76 08 41 51</string></value>
</member>
<member><name>fax</name>
<value><string>04 76 08 57 20</string></value>
</member>
<member><name>email</name>
<value><string>info@ra.le-touvet.citroen.fr</string></value>
</member>
<member><name>name</name>
<value><string>GARAGE POULAT ANDRE</string></value>
</member>
<member><name>description</name>
<value><string></string></value>
</member>
<member><name>image</name>
<value><string></string></value>
</member>
<member><name>approved_manufacturer</name>
<value><array>
<data>
<value><struct>
<member><name>name</name>
<value><string>Citroën</string></value>
</member>
<member><name>image</name>
<value><string>images/logo_citroen.jpg</string></value>
</member>
<member><name>website</name>
<value><string>http://www.citroen.fr</string></value>
</member>
</struct></value>
</data>
</array></value>
</member>
<member><name>car_maintenance_network</name>
<value><array>
<data>
</data>
</array></value>
</member>
<member><name>recommended_by</name>
<value><array>
<data>
</data>
</array></value>
</member>
<member><name>address</name>
<value><struct>
<member><name>garageId</name>
<value><string>1345</string></value>
</member>
<member><name>latitude</name>
<value><string>0.000000</string></value>
</member>
<member><name>longitude</name>
<value><string>0.000000</string></value>
</member>
<member><name>accuracy</name>
<value><string>0</string></value>
</member>
<member><name>CountryNameCode</name>
<value><string></string></value>
</member>
<member><name>AdministrativeAreaName</name>
<value><string></string></value>
</member>
<member><name>SubAdministrativeAreaName</name>
<value><string></string></value>
</member>
<member><name>LocalityName</name>
<value><string>LE TOUVET</string></value>
</member>
<member><name>DependentLocalityName</name>
<value><string></string></value>
</member>
<member><name>ThoroughfareName</name>
<value><string>RN 90 - -LES ALIQUETS</string></value>
</member>
<member><name>PostalCodeNumber</name>
<value><string>38660</string></value>
</member>
</struct></value>
</member>
<member><name>avis</name>
<value><string></string></value>
</member>
</struct></value>
</param>
</params>
</methodResponse>
struct search(int type,string query)

permet de trouver un garage a partir du nom, du code postal ou de la ville

Le type de recherche doit être 1 (recherche par ville), 2 code postal) ou 3 (nom du garage).

string setComment(int idGarage,string comment,int note,string IP)

permet d’ajouter un commentaire sur un garage. (L’IP correspond à l’IP du client qui veut déposer un commentaire, et pas au serveur qui fait l’appel à la méthode). La note est comprise entre 0 et 5.

Pour information, la bibliothèque XMLRPC pour PHP a été utilisée. Vous pouvez la télécharger ici.

Pour éviter tout problème, une authentification (type Basic Authentication) a été ajoutée. Il suffit de me contacter pour avoir un login/password.

 

Pour les développeurs PHP, vous pouvez utiliser le debugger pour tester votre code client, et même génerer le code client.

Une version JSONRPC peut être mise à disposition si besoin

Tags : API, developpeur, XMLRPC