GitScrum / Docs

Actividad

Accede a feeds de actividad, actividad de usuarios, notificaciones e historial de workflow.

REST API — Todos los endpoints requieren autenticación mediante Bearer token. Incluye Authorization: Bearer {token} en cada solicitud. Los tokens se gestionan en Configuración de GitScrum → API. Base URL: https://services.gitscrum.com — Todas las rutas de solicitud en esta documentación son relativas a esta URL base.

Los endpoints de actividad proporcionan visibilidad sobre lo que está sucediendo en tu workspace — desde feeds a nivel de proyecto hasta actividad individual de usuarios e historial de workflow de tareas.

Feed de actividad

Devuelve el feed de actividad de un proyecto.

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

Parámetros de query

ParámetroTipoRequeridoDescripción
company_slugstringIdentificador del workspace
project_slugstringIdentificador del proyecto

Ejemplo de solicitud

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

Ejemplo de respuesta

{
  "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"
    }
  ]
}

Actividad del usuario

Devuelve la actividad de un usuario específico.

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

Parámetros de ruta

ParámetroTipoDescripción
usernamestringNombre de usuario del usuario objetivo

Ejemplo de solicitud

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

Notificaciones

Devuelve las notificaciones del usuario autenticado.

GET /feeds/notifications

Ejemplo de solicitud

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

Registro de actividades

Devuelve un registro detallado de actividades de un proyecto.

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

Parámetros de query

ParámetroTipoRequeridoDescripción
company_slugstringIdentificador del workspace
project_slugstringIdentificador del proyecto

Historial de workflow

Devuelve el historial de cambios de columna de una tarea específica, mostrando cómo se movió a través de las columnas Kanban a lo largo del tiempo.

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

Parámetros de ruta

ParámetroTipoRequeridoDescripción
uuidstringUUID de la tarea

Parámetros de query

ParámetroTipoRequeridoDescripción
company_slugstringIdentificador del workspace
project_slugstringIdentificador del proyecto

Ejemplo de solicitud

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}"

Referencia de campos

CampoTipoDescripción
idintegerIdentificador de la entrada de actividad
typestringTipo de evento (ej., task.created, task.moved, comment.added)
descriptionstringDescripción legible
userobjectActor (username, name)
resource_typestringTipo de recurso afectado (task, sprint, wiki, etc.)
resource_idstringIdentificador del recurso afectado
created_atstringTimestamp del evento