Intégrer une application tierce

2019-03-11 13:36:03    Renee    3085

Avec ZenTao 9.6+, vous pouvez intégrer des applications tierces dans ZenTao, afin de partager vos données. L'application tierce peut accéder à ZenTao via GET, et ZenTao renverra les données au format .json.

1. Configurer

Connectez-vous à ZenTao en tant que super-administrateur, accédez à Admin-> Développer-> Entrée et cliquez sur Ajouter une application.


Entrez ensuite les informations de l'application que vous souhaitez ajouter à ZenTao.

  • Nom: le nom de l'application
  • Code: l'alias de l'application
  • Clé: la clé est générée automatiquement dans ZenTao
  • IP: il s'agit d'une liste blanche d'IP. Vérifier tout signifie qu'il n'y a aucune limite à aucune adresse IP.

2. Authentification API

L'authentification API est requise lorsque les applications tierces demandent des données à ZenTao. Le format est  /api.php?m=moduleName&f=methodName& params=params &code=code&token=token

  • m=moduleName&f=methodName& params=params sont les paramètres que la demande de données, et vous devez le définir en fonction de votre propre situation.
  • code est l'alias de l'application et doit être le même que celui de ZenTao.
  • token est une authentification numérique et son algorithme consiste à supprimer md5 et à ajouter une clé, puis à ajouter à nouveau md5.

Par exemple, le code de l'application est myApp et la clé est 427c579384224abf9570779d82969d1e, donc l'algorithme du jeton est comme indiqué ci-dessous,


$key   = '427c579384224abf9570779d82969d1e';
$query = 'm=project&f=view&id=1&code=myApp';
$token = md5(md5($query) . $key);

3. Code d'erreur

300001 Aucun paramètre de code. Vérifiez si l'API demandée contient le code.

300002 Aucun paramètre de jeton. Vérifiez si l'API demandée contient le jeton.

310001 L'application n'existe pas. Vérifiez si l'application demandée existe dans ZenTao ou si elle a été supprimée.

310002 L'application n'a pas de clé configurée. Vérifiez si l'application demandée a une clé configurée.

320001 IP est restreint. Vérifiez le paramètre IP de cette application demandée dans ZenTao.

330001 Paramètres de jeton non valides. 


Si une redirection se produit lors de la demande, ZenTao doit vérifier la session pour authentifier si la demande après la redirection est valide. Par exemple, lorsqu'une méthode d'index est demandée dans le module d'index, elle sera redirigée vers la méthode d'index dans mon module.

340001  Pas de code de session. Vérifiez si  $_SESSION['ENTRY_CODE'] est correct après la redirection.

340002  L'authentification de session a échoué. Vérifiez la logique d'authentification de la session, ainsi que si $_SERVER['REMOTE_ADDR']  est correct après la redirection.