Utilisation des services

Appel

les paramètres d'appel des services web sont de deux types :

  • Obligatoire pour toutes les méthodes.

  • Méthode : spécifiques à chaque méthode. Ils peuvent être obligatoires ou optionnels.

Paramètres obligatoires

identifiant : identifiant fourni lors de votre abonnement aux services webs

cle : clé de l'abonnement encryptée

methode : nom de la méthode appelée.

type_wok: type de wok ( book,music,cine, games). Vous devez avoir un abonnement au wok demandé.

AttentionEncryptage de la clé

Pour des raisons de sécurité, la clé est encryptée.

Lors de votre abonnement, nous vous fournissons une clé secrète qui vous servira à encrypter la clé et les mots de passe. Nous nous servirons de cette même clé pour décrypter ces éléments de notre coté.

La méthode d'encryptage retenue est ecb, avec l'algorythme Rijndael 256bits

Voici un exemple d'encryptage en php

$encryptee = trim(base64_encode(mcrypt_encrypt(MCRYPT_RIJNDAEL_256, $cleSecrete, $chaine, MCRYPT_MODE_ECB, mcrypt_create_iv(mcrypt_get_iv_size(MCRYPT_RIJNDAEL_256, MCRYPT_MODE_ECB), MCRYPT_RAND))));

ou $encrypted est la chaine encryptée, $cleSecrete la clé secrète et $chaine la chaîne de caractères à encrypter.

Remarque

Dans l'attente d'une évolution éventuelle, le paramètre format n'est pas obligatoire et a pour valeur par défaut json

Paramètres de méthode

objectId : identifiant d'un objet . Unique sur l'ensemble du site CultureWok

objectWokId : identifiant d'une instance d'un objet dans un wok utilisateur.

UserWokId : identifiant CultureWok de l'utilisaeur (fourni par la méthode infoWok

Type_wok : : type du wok à utiliser pour la méthode.

Réponses

Les réponses intégrées dans un élément de tableau de clé reponseWok

Le contenu de cet élément est spécifique à chaque méthode.

AttentionGestion des erreurs

En cas d'erreur lors de l'exécution d'une méthode, la réponse est un tableau avec un seul élément de clé erreur contenant un message d'explication