{"id":36979190,"url":"https://github.com/libertempo/api","last_synced_at":"2026-01-13T22:48:48.164Z","repository":{"id":18103753,"uuid":"83347929","full_name":"libertempo/api","owner":"libertempo","description":"API de l'application web Libertempo","archived":false,"fork":false,"pushed_at":"2022-03-29T22:31:28.000Z","size":8534,"stargazers_count":1,"open_issues_count":9,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-09-18T07:50:08.401Z","etag":null,"topics":["api","beginner-friendly","conges","leave","libre"],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/libertempo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-02-27T19:26:07.000Z","updated_at":"2022-06-12T22:50:48.000Z","dependencies_parsed_at":"2022-09-01T23:42:05.330Z","dependency_job_id":null,"html_url":"https://github.com/libertempo/api","commit_stats":null,"previous_names":[],"tags_count":22,"template":false,"template_full_name":null,"purl":"pkg:github/libertempo/api","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/libertempo%2Fapi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/libertempo%2Fapi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/libertempo%2Fapi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/libertempo%2Fapi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/libertempo","download_url":"https://codeload.github.com/libertempo/api/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/libertempo%2Fapi/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28403703,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-13T14:36:09.778Z","status":"ssl_error","status_checked_at":"2026-01-13T14:35:19.697Z","response_time":56,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","beginner-friendly","conges","leave","libre"],"created_at":"2026-01-13T22:48:47.441Z","updated_at":"2026-01-13T22:48:48.150Z","avatar_url":"https://github.com/libertempo.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# libertempo-api\n[![BCH compliance](https://bettercodehub.com/edge/badge/libertempo/api?branch=master)](https://bettercodehub.com/)\n[![Codacy Badge](https://api.codacy.com/project/badge/Grade/c9248e3a815347209c8e56d2291f0da7)](https://www.codacy.com/app/libertempo/api)\n[![Codacy Badge](https://api.codacy.com/project/badge/Coverage/c9248e3a815347209c8e56d2291f0da7)](https://www.codacy.com/app/libertempo/api)\n[![Build Status](https://travis-ci.org/libertempo/api.svg?branch=master)](https://travis-ci.org/libertempo/api)\n\n## Panthéon\n[![](https://sourcerer.io/fame/prytoegrian/libertempo/api/images/0)](https://sourcerer.io/fame/prytoegrian/libertempo/api/links/0)[![](https://sourcerer.io/fame/prytoegrian/libertempo/api/images/1)](https://sourcerer.io/fame/prytoegrian/libertempo/api/links/1)[![](https://sourcerer.io/fame/prytoegrian/libertempo/api/images/2)](https://sourcerer.io/fame/prytoegrian/libertempo/api/links/2)[![](https://sourcerer.io/fame/prytoegrian/libertempo/api/images/3)](https://sourcerer.io/fame/prytoegrian/libertempo/api/links/3)[![](https://sourcerer.io/fame/prytoegrian/libertempo/api/images/4)](https://sourcerer.io/fame/prytoegrian/libertempo/api/links/4)[![](https://sourcerer.io/fame/prytoegrian/libertempo/api/images/5)](https://sourcerer.io/fame/prytoegrian/libertempo/api/links/5)[![](https://sourcerer.io/fame/prytoegrian/libertempo/api/images/6)](https://sourcerer.io/fame/prytoegrian/libertempo/api/links/6)[![](https://sourcerer.io/fame/prytoegrian/libertempo/api/images/7)](https://sourcerer.io/fame/prytoegrian/libertempo/api/links/7)\n\nAPI Libertempo\n---\n\n# Initialisation\nL'installation sous sa forme la plus simple se résume à faire :\n```sh\ngit clone git@github.com:libertempo/api.git\ncd api\nmake install\nln -sf `pwd`/Tools/Scripts/post-checkout .git/hooks/post-checkout\n```\n\nL'API Libertempo doit être installée comme un domaine à part, autrement dit :\n- api.libertempo.tld\n- api.libertempo.mon-entreprise.tld\n\nEt non pas comme un sous-répertoire de votre domaine existant :\n- mon-entreprise.tld/libertempo/api\n- libertempo.mon-entreprise.tld/api\n\nC'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).\n\nLes échanges se font en JSON et nous suivons les codes HTTP standards.\n\n# Requête\nEn 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.\n\nLes headers basiques, à transmettre pour toute requête, sont :\n```\nContent-Type: application/json\nAccept: application/json\n```\n\n## Première requête\nAfin de vérifier que l'installation de l'API s'est bien déroulée, nous avons mis en place une route sans authentification :\n```\nGET /hello_world\n```\n\n## Authentification\nL'authentification s'appuie sur la méthode [Basic Access](https://en.wikipedia.org/wiki/Basic_access_authentication) :\n```\nGET /authentification\nAuthorization: Basic {base64(login:mot_de_passe)}\n```\n\nSi 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).\n\n## Échanges authentifiés\nUne fois connecté, tous les échanges devront avoir le header :\n```\nToken: {token}\n```\n\n## Requêtes avec données\nLors d'un ordre avec données (POST | PUT), le corps de la requête doit ressembler à :\n```JSON\n{\n    \"propriété1\": \"valeur1\",\n    \"propriétéN\": \"valeurN\"\n}\n```\n\n# Réponse\n\nLes réponses de l'API se font sous la spécification jsend. Autrement dit :\n```JSON\n{\n    \"code\": \"codeHTTP\",\n    \"status\": \"typeDeReponse\",\n    \"message\": \"messageCorrespondantAuCode\",\n    \"data\": \"donnéesDeRéponse\"\n}\n```\n\n# Routes disponibles\nVoir [Swagger](https://app.swaggerhub.com/apis/Libertempo/api) pour une documentation exhaustive.\n\n# Versions\n\nL'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é](https://github.com/Prytoegrian/check-break#what-is-a-compatibility-break-) .\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flibertempo%2Fapi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flibertempo%2Fapi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flibertempo%2Fapi/lists"}