E-LOGIK Planning RH — API de lecture seule v1.0.0

Consultation de votre planning jour par jour. Lecture seule, périmètre limité à l'employé lié à votre compte.

Authentification

Jeton personnel créé depuis « Mon profil → Accès API » de l'application. Préfixé « elpk_ ».

Envoyez-le sur chaque requête :

Authorization: Bearer elpk_votre_jeton

Le jeton n'est affiché qu'une seule fois, à sa création : conservez-le comme un mot de passe, et révoquez-le depuis l'application si vous le pensez compromis.

GET /api/v1/planning/jours

Planning jour par jour sur une plage de dates.

Renvoie tous les jours de la plage, bornes incluses — week-ends, jours fériés et jours sans saisie compris — afin de livrer un calendrier continu. Chaque jour ouvré est décodé en une moitié matin et une moitié après-midi. La plage ne peut pas dépasser 366 jours.

Paramètres

Exemple d'appel

curl -s 'https://planning.e-logik.fr/api/v1/planning/jours?debut=2026-09-01&fin=2026-09-30' \
  -H 'Authorization: Bearer elpk_votre_jeton'

Exemple de réponse

{
  "employe": {
    "code": "EXE",
    "nom": "Camille Exemple",
    "service": "Exploitation"
  },
  "debut": "2026-09-03",
  "fin": "2026-09-06",
  "jours": [
    {
      "date": "2026-09-03",
      "jour_semaine": 4,
      "ouvre": true,
      "ferie": false,
      "matin": {
        "code": "CP",
        "libelle": "Congé payé",
        "saisi": true
      },
      "apres_midi": {
        "code": "TT",
        "libelle": "Télétravail",
        "saisi": true
      },
      "note": "",
      "modifie_le": "2026-08-28T09:12:04Z"
    },
    {
      "date": "2026-09-04",
      "jour_semaine": 5,
      "ouvre": true,
      "ferie": false,
      "matin": {
        "code": "P",
        "libelle": "Présent",
        "saisi": false
      },
      "apres_midi": {
        "code": "P",
        "libelle": "Présent",
        "saisi": false
      },
      "note": "",
      "modifie_le": null
    },
    {
      "date": "2026-09-05",
      "jour_semaine": 6,
      "ouvre": false,
      "ferie": false,
      "matin": null,
      "apres_midi": null,
      "note": "",
      "modifie_le": null
    },
    {
      "date": "2026-09-06",
      "jour_semaine": 7,
      "ouvre": false,
      "ferie": false,
      "matin": {
        "code": "D",
        "libelle": "Déplacement",
        "saisi": true
      },
      "apres_midi": {
        "code": "D",
        "libelle": "Déplacement",
        "saisi": true
      },
      "note": "salon professionnel",
      "modifie_le": "2026-09-01T16:40:00Z"
    }
  ]
}

Codes de statut du planning

• Un jour ouvré sans saisie vaut « présent au bureau » : l'API renvoie alors P avec saisi: false.
• Une saisie posée un week-end ou un jour férié est restituée comme les autres : « ouvre » reste à false, mais les moitiés portent le statut stocké. Les moitiés ne valent null que sur un jour non ouvré SANS aucune saisie.
• Sur une demi-journée, « periode » vaut « am » pour le matin ; toute autre valeur — « pm », colonne vide ou non renseignée — désigne l'après-midi. C'est la convention de l'application, et la colonne est absente des données chargées par l'import : le repli après-midi est donc le cas courant, pas une exception.
• Sur une demi-journée combinée, l'ordre encode les moitiés : le premier terme est le matin.
• Un code hors de la liste publiée est relayé tel quel, son libellé valant alors le code.

Codes d'erreur

Toutes les erreurs ont la même forme : {"error":{"code":…,"message":…}}.

Contrat machine

La spec OpenAPI 3.1 est servie sur /api/v1/openapi.json : importable dans Postman, Insomnia ou Bruno, ou utilisable pour générer un client.