Skip to content
Navigation

Lister les types d’astreinte

Liste paginée des types d’astreinte, par libellé, avec leur contrepartie brute par période (PERIOD) ou par heure (HOUR). Une période d’astreinte désigne son type par onCallTypeId.

Les types se gèrent dans Puncto (Équipe › Astreintes). 400 si le module des astreintes n’est pas activé.

GET
https://api.puncto.fr/public/v1/on-call-types

Authentification

  • bearerAuth
    HTTP
    requis

Query parameters

  • page
    optionnel
    integer

    Numéro de page, à partir de 1.

    minimum: 1 · default: 1
  • perPage
    optionnel
    integer

    Nombre d’éléments par page, 200 au plus.

    maximum: 200 · minimum: 1 · default: 50

Retour

200

Page de types d’astreinte

JSON
  • data
    tableau de
    object
    requis
    • onCallTypeId
      string
      requis

      Identifiant Puncto du type d'astreinte, à passer en onCallTypeId à l'import des périodes

    • label
      string
      requis

      Libellé, unique dans l'entreprise : utilisable en onCallTypeLabel à l'import des périodes

    • compensation
      object
      requis

      Contrepartie copiée sur chaque période à son import : modifier le barème ne change pas les périodes déjà enregistrées

      • mode
        string
        requis

        Mode de calcul de la contrepartie : un montant fixe par unité, seul mode disponible

      • unit
        PERIOD
        ou
        HOUR
        requis

        Unité décomptée : la période entière (PERIOD, une nuit, un week-end...), dont le nombre est importé avec la période, ou l'heure d'astreinte (HOUR), calculée sur la durée de la période

      • amount
        number
        requis

        Montant brut par unité, en euros

    • isActive
      boolean
      requis

      Un type désactivé ne sert plus aux nouvelles périodes ; celles déjà importées le gardent

    • isUsed
      boolean
      requis

      Au moins une période d'astreinte utilise ce type

  • meta
    object
    requis
    • total
      integer
      requis

      Nombre total d’éléments.

    • page
      integer
      requis

      Page renvoyée.

    • perPage
      integer
      requis
    • currentPage
      integer
      requis
    • firstPage
      integer
      requis
    • lastPage
      integer
      requis

400

Astreintes non activées pour l’entreprise
JSON
  • error
    string
    requis

    Message lisible, en français.

  • errorCode
    optionnel
    string

    Code stable, sur certaines erreurs.

401

Clé d’API absente, invalide ou révoquée
JSON
  • error
    string
    requis

    Message lisible, en français.

  • errorCode
    optionnel
    string

    Code stable, sur certaines erreurs.

403

Opération hors de l’accès de la clé d’API
JSON
  • error
    string
    requis

    Message lisible, en français.

  • errorCode
    optionnel
    string

    Code stable, sur certaines erreurs.

422

Paramètres invalides
JSON
  • errors
    tableau de
    object
    requis
    • message
      string
      requis
    • rule
      string
      requis

      Règle de validation en échec.

    • field
      string
      requis

      Chemin du champ, par exemple absences.0.type.

Type to search…

↑↓ navigate↵ selectEsc close