IntroductionPour utiliser l'API wmaker vous devez utiliser la convention d'appel REST, envoyer une requête à son url API en spécifiant une méthode et des arguments, puis vous recevez une réponse formatée. Toutes les requêtes doivent utiliser une liste de paramètres nommés :
Signature [api_sig] est une signature de méthode, elle se calcule avec cette fonction.api_sig = md5(API_SECRET + API_KEY + METHOD_NAME) Exemple de code en PHP : function generateSig($method) { return(md5($this->api_secret . $this->api_key . $method)); } Si vous utilisez le Kit API Wmaker (fourni dans l'espace téléchargement) ce dernier génère automatiquement pour vous l'api_sig dans chaque appel API. Response FormatsWe offer three response types in our API : XML, PHP and JSONXML (REST)
The REST response is really simple. It's just a very simple XML output. This is the default response method, so you don't need to specify the format parameter.
<rsp stat="ok" generated_in="0.07157"> <comment> <id>852331</id> <object_id>1418360</object_id> <date>2009-06-08 17:22:00</date> <email>tvolterrani@memup.com</email> <name>Thomas VOLTERRANI</name> <message>Bravo ! C'est tout ce que je peux dire !</message> <url>http://www.memup.com</url> </comment> </rsp> In the event of an error, you'll get something like this : <rsp stat="fail"> <err code="96" msg="comment Not found"/> </rsp> PHP
The PHP result is a serialized version of the REST format. So the responses will be the same as above, only as PHP objects. If you're using the PHP response, we encourage you to look at the example code we provide.
stdClass Object JSON
JSON (JavaScript Object Notation) is a lightweight computer data interchange format. It is a text-based, human-readable format for representing objects and other data structures and is mainly used to transmit such structured data over a network connection (in a process called serialization)
To get an API response in JSON format, send a parameter format in the request with a value of json . {In the event of an error, you'll get something like this: { |
|
© WMaker 2009 | CampusPlex™
|