API de statistiques de projet - Gitlabhq

Édition : Gratuite, GitLab Premium, GitLab Ultimate
Offre : GitLab.com, GitLab Self-Managed, GitLab Dedicated

Utilisez cette API pour récupérer des statistiques sur un projet. Tous les endpoints nécessitent une authentification.

Vous devez disposer d'un accès en lecture au dépôt. Les jetons d'accès personnels doivent avoir la portée read_api. Les jetons d'accès de groupe peuvent utiliser le rôle Reporter et la portée read_api.

Cette API récupère le nombre de fois où le projet est cloné ou récupéré via la méthode HTTP. Les récupérations SSH ne sont pas incluses.

Récupérer les statistiques des 30 derniers jours {#retrieve-the-statistics-of-the-last-30-days}

Récupère les statistiques de clonage et de récupération des 30 derniers jours à partir d'un projet spécifié.

plaintext

GET /projects/:id/statistics

Attributs pris en charge :

Attribut	Type	Obligatoire	Description
`id`	entier ou chaîne	Oui	ID ou chemin encodé en URL du projet.

En cas de succès, renvoie 200 OK et les attributs de réponse suivants :

Attribut	Type	Description
`fetches`	objet	Statistiques de récupération pour le projet.
`fetches.days`	tableau	Tableau des statistiques de récupération quotidiennes.
`fetches.days[].count`	entier	Nombre de récupérations pour la date spécifique.
`fetches.days[].date`	string	Date au format ISO (`YYYY-MM-DD`).
`fetches.total`	entier	Nombre total de récupérations pour les 30 derniers jours.

Exemple de requête :

shell

curl --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/projects/42/statistics"

Exemple de réponse :

json

{
  "fetches": {
    "total": 50,
    "days": [
      {
        "count": 10,
        "date": "2018-01-10"
      },
      {
        "count": 10,
        "date": "2018-01-09"
      },
      {
        "count": 10,
        "date": "2018-01-08"
      },
      {
        "count": 10,
        "date": "2018-01-07"
      },
      {
        "count": 10,
        "date": "2018-01-06"
      }
    ]
  }
}