GitScrum / Docs

Pièce Jointe Ajoutée

Référence de payload du webhook pour l'événement attachments.issues.store, déclenché lorsqu'un fichier est joint à une tâche.

Déclenché lorsqu'un fichier est joint à une tâche.

  • Événement : attachments.issues.store
  • Catégorie : Tâches
  • Déclencheurs : Téléversement d'un fichier vers une tâche dans le panneau de détails de la tâche

Payload

Le payload contient la ressource complète de la pièce jointe via AttachmentResource :

{
  "id": 789,
  "uuid": "attachment-uuid-789",
  "resource": {
    "type": "task",
    "uuid": "abc123-def456-ghi789"
  },
  "description": null,
  "download": {
    "url": "https://s3.amazonaws.com/bucket/file.pdf?signed=...",
    "internal": "https://services.gitscrum.com/attachments/attachment-uuid-789",
    "expiration": "2026-02-06T15:30:00+00:00"
  },
  "filename": "design-spec.pdf",
  "mimetype": "application/pdf",
  "size": 245760,
  "folder_id": null,
  "folder": null,
  "show_in_carousel": false,
  "is_mine": true,
  "user": {
    "id": 1,
    "uuid": "user-uuid-123",
    "name": "Jane Smith",
    "username": "janesmith",
    "avatar": "https://avatar.url/jane.jpg",
    "headline": "Lead Developer",
    "location": "Porto, Portugal",
    "timezone_name": "Europe/Lisbon",
    "language": "en",
    "created_at": {
      "date_for_humans": "1 year ago",
      "iso8601": "2025-01-15T10:00:00+00:00",
      "timestamp": 1736935200
    }
  },
  "task": null,
  "comments": 0,
  "project": {
    "slug": "web-platform",
    "name": "Web Platform",
    "logo": "https://logo.url/project.png",
    "visibility": {
      "is_private": 1,
      "title": "Private"
    },
    "recurring": true,
    "owner": { ... }
  },
  "created_at": {
    "date_for_humans": "Just now",
    "iso8601": "2026-02-06T14:30:00+00:00",
    "timestamp": 1738852200
  }
}

Référence des Champs

ChampTypeDescription
idintegerID de la pièce jointe
uuidstringUUID de la pièce jointe
resource.typestringType de ressource parente ("task")
resource.uuidstringUUID de la tâche parente
descriptionstring ou nullDescription de la pièce jointe
download.urlstringURL de téléchargement S3 signée (temporaire)
download.internalstringURL de téléchargement interne GitScrum
download.expirationstringDate et heure d'expiration de l'URL
filenamestringNom de fichier original
mimetypestringType MIME
sizeintegerTaille du fichier en octets
folder_idinteger ou nullID du dossier (si organisé en dossiers)
folderobject ou nullDétails du dossier : id, uuid, name, path
showincarouselbooleanSi la pièce jointe s'affiche dans le carrousel d'images
userobjectUtilisateur qui a téléversé le fichier
commentsinteger ou nullNombre de commentaires sur la pièce jointe
projectobjectDétails du projet
created_atobjectHorodatage du téléversement

Notes

  • L'download.url est une URL S3 signée avec un délai d'expiration. Elle peut expirer avant que votre système ne la traite.
  • Utilisez download.internal pour une URL de téléchargement plus stable.
  • Le champ size est en octets.

Associé