GitScrum / Docs

Activité

Accédez aux flux d'activité, activité des utilisateurs, notifications et historique de workflow.

REST API — Tous les endpoints nécessitent une authentification par Bearer token. Incluez Authorization: Bearer {token} dans chaque requête. Les tokens sont gérés dans Paramètres GitScrum → API. Base URL: https://services.gitscrum.com — Tous les chemins de requête dans cette documentation sont relatifs à cette URL de base.

Les endpoints d'activité offrent une visibilité sur ce qui se passe dans votre workspace — des flux au niveau projet à l'activité individuelle des utilisateurs et l'historique de workflow des tâches.

Flux d'activité

Retourne le flux d'activité d'un projet.

GET /feeds?company_slug={slug}&project_slug={slug}

Paramètres de requête

ParamètreTypeRequisDescription
company_slugstringOuiIdentifiant du workspace
project_slugstringOuiIdentifiant du projet

Exemple de requête

curl -X GET "https://services.gitscrum.com/feeds?company_slug=acme&project_slug=web-app" \
  -H "Authorization: Bearer {token}"

Exemple de réponse

{
  "data": [
    {
      "id": 5432,
      "type": "task.created",
      "description": "created task \"Add password reset flow\"",
      "user": {
        "username": "johndoe",
        "name": "John Doe"
      },
      "resource_type": "task",
      "resource_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "created_at": "2026-02-07T14:00:00Z"
    },
    {
      "id": 5431,
      "type": "task.moved",
      "description": "moved task \"Implement auth\" to In Progress",
      "user": {
        "username": "janedoe",
        "name": "Jane Doe"
      },
      "resource_type": "task",
      "resource_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "created_at": "2026-02-07T13:45:00Z"
    }
  ]
}

Activité d'un utilisateur

Retourne l'activité d'un utilisateur spécifique.

GET /feeds/user/{username}?company_slug={slug}&project_slug={slug}

Paramètres de chemin

ParamètreTypeDescription
usernamestringNom d'utilisateur de la cible

Exemple de requête

curl -X GET "https://services.gitscrum.com/feeds/user/johndoe?company_slug=acme&project_slug=web-app" \
  -H "Authorization: Bearer {token}"

Notifications

Retourne les notifications de l'utilisateur authentifié.

GET /feeds/notifications

Exemple de requête

curl -X GET "https://services.gitscrum.com/feeds/notifications" \
  -H "Authorization: Bearer {token}"

Journal d'activités

Retourne un journal d'activité détaillé d'un projet.

GET /activities?company_slug={slug}&project_slug={slug}

Paramètres de requête

ParamètreTypeRequisDescription
company_slugstringOuiIdentifiant du workspace
project_slugstringOuiIdentifiant du projet

Historique de workflow

Retourne l'historique des changements de colonne d'une tâche spécifique, montrant comment elle a évolué à travers les colonnes Kanban au fil du temps.

GET /activities/task/{uuid}/workflow?company_slug={slug}&project_slug={slug}

Paramètres de chemin

ParamètreTypeRequisDescription
uuidstringOuiUUID de la tâche

Paramètres de requête

ParamètreTypeRequisDescription
company_slugstringOuiIdentifiant du workspace
project_slugstringOuiIdentifiant du projet

Exemple de requête

curl -X GET "https://services.gitscrum.com/activities/task/a1b2c3d4-e5f6-7890-abcd-ef1234567890/workflow?company_slug=acme&project_slug=web-app" \
  -H "Authorization: Bearer {token}"

Référence des champs

ChampTypeDescription
idintegerIdentifiant de l'entrée d'activité
typestringType d'événement (ex. : task.created, task.moved, comment.added)
descriptionstringDescription lisible
userobjectActeur (username, name)
resource_typestringType de ressource affectée (task, sprint, wiki, etc.)
resource_idstringIdentifiant de la ressource affectée
created_atstringHorodatage de l'événement