Ci-dessous, les différences entre deux révisions de la page.
Les deux révisions précédentes Révision précédente Prochaine révision | Révision précédente | ||
restler [2019/06/03 14:19] unareil [Format des données] |
restler [2019/06/03 15:30] unareil Problème de majuscule |
||
---|---|---|---|
Ligne 1: | Ligne 1: | ||
====== Créer votre propre API REST avec [[Restler]] ====== | ====== Créer votre propre API REST avec [[Restler]] ====== | ||
- | Ce tutoriel utilise le programme open source [[Restler 3.0 de Luracast]] pour créer une API REST. | + | Ce tutoriel utilise le programme open source [[Restler 3.0 de Luracast]] pour créer une API REST. |
+ | |||
+ | Détail de l'installation de Restler sur Debian GNU/Linux 9 (stretch) 64 bits équipé d'un serveur LAMP [[installation Restler|ici]]. | ||
Commençons par quelque chose de simple : nous allons créer une classe Dis.php qui quand elle sera appelé renverra bonjour suivi du paramètre passer à l'URL. | Commençons par quelque chose de simple : nous allons créer une classe Dis.php qui quand elle sera appelé renverra bonjour suivi du paramètre passer à l'URL. | ||
Ligne 29: | Ligne 31: | ||
</code> | </code> | ||
C'est fait la plateforme est prête à prendre en compte les requêtes de type REST en utilisant l'URL suivante : | C'est fait la plateforme est prête à prendre en compte les requêtes de type REST en utilisant l'URL suivante : | ||
- | <code> | + | |
- | index.php/dis/bonjour/Aurélien Martineau | + | ''index.php/Dis/bonjour/Aurélien Martineau'' |
- | </code> | + | |
C'est fait, nous avons réussit à créer une classe et à l'exposer à la méthode de l'URL pour que celle-ci renvoie des informations à l'utilisateur. | C'est fait, nous avons réussit à créer une classe et à l'exposer à la méthode de l'URL pour que celle-ci renvoie des informations à l'utilisateur. | ||
Ligne 72: | Ligne 74: | ||
- | Si vous visitez l'url localhost/index.php/individu/1, Restler utilisera la méthode GET car c'est celle préconisée en Restfull et vous retournera l'enregistrement 1 correspondant à votre base de données. Si vous ne spécifiez d'ID pour un individu tous les enregistrements vous seront retournés par défaut. | + | Si vous visitez l'url ''localhost/index.php/individu/1'', Restler utilisera la méthode GET car c'est celle préconisée en Restfull et vous retournera l'enregistrement 1 correspondant à votre base de données. Si vous ne spécifiez d'ID pour un individu tous les enregistrements vous seront retournés par défaut. |
===== Les différents types d'erreur ===== | ===== Les différents types d'erreur ===== | ||
Ligne 128: | Ligne 130: | ||
</code> | </code> | ||
- | Maintenant, si vous visitez la page localhost/index.php/individu/10, vous aurez le message d'erreur 400 avec le message Cet ID n'existe pas. | + | Maintenant, si vous visitez la page ''localhost/index.php/individu/10'', vous aurez le message d'erreur 400 avec le message ''Cet ID n'existe pas''. |
Restler permet d'afficher les erreurs à l'utilisateur si vous le souhaitez. Si c'est le cas, le script n'exécutera alors aucune autre action. | Restler permet d'afficher les erreurs à l'utilisateur si vous le souhaitez. Si c'est le cas, le script n'exécutera alors aucune autre action. | ||
Ligne 141: | Ligne 143: | ||
</code> | </code> | ||
- | Ainsi par défaut, il retournera du json, mais il pourra également accepté du XML si vous faites la requête suivante : <code>localhost/index.php/person.xml/1</code>. | + | Ainsi par défaut, il retournera du json, mais il pourra également accepté du XML si vous faites la requête suivante : ''localhost/index.php/person.xml/1''. |