Annotations

Marquez une date sur la chronologie du projet (lancement de campagne, migration de site, refonte) pour qu’un graphique montre ce qui s’est passé et quand. Disponible sur tous les forfaits.

POST/annotations

Marque une date sur la chronologie du projet avec un titre et une description. Disponible sur tous les forfaits.

Corps (JSON) :
  • project_idobligatoire
  • titleobligatoire
  • annotation_datefacultatif, format ISO AAAA-MM-JJ ; aujourd’hui par défaut
  • descriptionfacultatif
  • colorfacultatif, hexadécimal
  • annotation_category_idfacultatif, doit appartenir au projet

GET /annotations + PATCH/DELETE /annotations/:id

Liste, modifie et supprime les annotations, sur tous les forfaits. GET renvoie les annotations manuelles, automatiques et de la plateforme, de la plus récente à la plus ancienne. Le champ origin les distingue, et editable indique si l’utilisateur à l’origine de la requête peut modifier une ligne. PATCH et DELETE ne fonctionnent que sur les annotations manuelles qui appartiennent à votre propre compte utilisateur (403 sinon).

  • Paramètres GET : project_id (obligatoire), from/to (AAAA-MM-JJ), annotation_category_id, page, per_page. Corps PATCH : un ou plusieurs des champs title, description, annotation_date, color, annotation_category_id. DELETE : project_id + :id dans l’URL.