Entité

Projets

Récupérer et gérer des projets, y compris les opérations d'insertion/mise à jour et de clonage.

Points d'extrémité

GET/api/v2/projectsRécupérer une liste

GET/api/v2/projects/{id}Récupérer un enregistrement

POST/api/v2/projectsCréer des enregistrements

PATCH/api/v2/projectsMise à jour des enregistrements

DELETE/api/v2/projects/{id}Supprimer un enregistrement

Mettre à jour un projet

POST/api/v2/projects/upsertCréer ou mettre à jour par clé externe

PUT/api/v2/projects/upsertCréer ou mettre à jour par clé externe

Fournissez une clé externe non vide (l'identifiant de votre système) et n'envoyez pas l'identifiant . Celoxis recherche un projet associé à cette clé externe au sein de votre entreprise ; s'il est trouvé, il est mis à jour ; sinon, il est créé. La réponse inclut le JSON habituel du projet, ainsi que l' action ( « créé » ou « mis à jour » ) et la valeur de succès: « true » . La clé externe doit être unique pour chaque entreprise. En cas de correspondances multiples, une erreur HTTP 409 est renvoyée.

frapper

Exemple

curl -X PUT \ -H 'Content-Type: application/json' \ -H 'Authorization: bearer YourTokenHere' \ -d '{ "externalKey": "ERP-P-1001", "name": "Refonte du site web", "workspace": 12345 }' \ 'https://app.celoxis.com/psa/api/v2/projects/upsert'

Cloner un projet

POST/api/v2/projects/{id}/cloneCréer un projet à partir d'un projet existant

Envoyez un objet JSON dans le corps de la requête contenant uniquement les propriétés qui doivent différer du projet source. La réponse est : { data: {created-object} }.

Pour cloner un projet dont l'identifiant est 123, avec un nom différent et une date de début prévue le 1er mai 2020 :

frapper

Exemple

curl -g -X POST \ -H 'Content-Type: application/json' \ -H 'Authorization: bearer YourTokenHere' \ -d '{ "name": "Créer un logo pour ABC.com", "plannedStart": "2020-05-01" }' \ 'https://app.celoxis.com/psa/api/v2/projects/123/clone'