Opérations communes
Insertion de données
Créer ou mettre à jour un enregistrement de projet, de tâche ou d'application de flux de travail à l'aide d'une clé externe.
Mise à jour par clé externe
/api/v2/{entity}/upsertCréer ou mettre à jour par clé externe/api/v2/{entity}/upsertCréer ou mettre à jour par clé externeLes entités prises en charge sont les projets, les tâches et les applications.
Fournissez une clé externe non vide (l'identifiant de votre système). Ne transmettez pas l'identifiant . Celoxis recherche un enregistrement correspondant à cette clé externe dans votre entreprise ; s'il est trouvé, il est mis à jour ; sinon, il est créé.
La réponse inclut l'entité JSON habituelle, l'action (créée ou mise à jour) et le succès : true. La clé externe doit être unique par entreprise et par type d'entité. Plusieurs correspondances renvoient une erreur HTTP 409.
Pour créer ou mettre à jour une tâche :
curl -g -X POST \ -H 'Content-Type: application/json' \ -H 'Authorization: bearer YourTokenHere' \ -d '{ "externalKey": "ERP-T-9876", "name": "Design review", "project": "ERP-P-1001" }' \ 'https://app.celoxis.com/psa/api/v2/tasks/upsert'Pour créer ou mettre à jour un projet :
curl -g -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'Pour créer ou mettre à jour un enregistrement d'application Workflow :
curl -g -X POST \ -H 'Content-Type: application/json' \ -H 'Authorization: bearer YourTokenHere' \ -d '{ "externalKey": "ERP-A-1001", "app": "Bug", "name": "Investigate login issue", "project": "ERP-P-1001" }' \ 'https://app.celoxis.com/psa/api/v2/apps/upsert'