Download the PHP package libertempo/api without Composer
On this page you can find all versions of the php package libertempo/api. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package api
libertempo-api
Panthéon
API Libertempo
Initialisation
L'installation sous sa forme la plus simple se résume à faire :
L'API Libertempo doit être installée comme un domaine à part, autrement dit :
- api.libertempo.tld
- api.libertempo.mon-entreprise.tld
Et non pas comme un sous-répertoire de votre domaine existant :
- mon-entreprise.tld/libertempo/api
- libertempo.mon-entreprise.tld/api
C'est préférable pour l'isolation des systèmes (donc la sécurité), en plus d'être plus simple à gérer côté applicatif (plus de certitudes, donc moins de bugs).
Les échanges se font en JSON et nous suivons les codes HTTP standards.
Requête
En tant qu'architecture REST, les échanges sont sans-état, ce qui signifie que le serveur ne stocke pas d'information pour se souvenir d'un client et n'induit rien. Cela implique que le client doit fournir toutes les informations nécessaires à la réalisation d'une action, passant tout d'abord par une connexion, puis la transmission à chaque requête du token reçu suite à cette connexion.
Les headers basiques, à transmettre pour toute requête, sont :
Première requête
Afin de vérifier que l'installation de l'API s'est bien déroulée, nous avons mis en place une route sans authentification :
Authentification
L'authentification s'appuie sur la méthode Basic Access :
Si l'utilisateur existe et a le droit de se connecter, l'API enverra le token d'identification, dont la durée de validité est de 30min (repoussée à chaque échange).
Échanges authentifiés
Une fois connecté, tous les échanges devront avoir le header :
Requêtes avec données
Lors d'un ordre avec données (POST | PUT), le corps de la requête doit ressembler à :
Réponse
Les réponses de l'API se font sous la spécification jsend. Autrement dit :
Routes disponibles
Voir Swagger pour une documentation exhaustive.
Versions
L'API suit semver
, ce qui signifie qu'une route ne sera enlevée ou que ses spécifications ne seront changées que si la version passe vM.0.0
. Autrement, il n'y aura pas de cassages de compatibilité .
All versions of api with dependencies
slim/slim Version 3.12.1
doctrine/dbal Version 2.9.2
doctrine/orm Version 2.6
php-di/php-di Version 6.0.8
adldap2/adldap2 Version 10.0.6
rollbar/rollbar Version 1.8.1