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