Contrats de travail par l'API

export COMUSFLOW_TOKEN="cfat_…"

curl -sS -H "Authorization: Bearer $COMUSFLOW_TOKEN" \
  "https://app.comusflow.com/api/v1/ma-salle/people?limit=100" | jq

{
  "data": [
    { "id": 314, "first_name": "Camille", "last_name": "Blanc",
      "email": "camille.blanc@example.org" },
    { "id": 271, "first_name": "Sacha",   "last_name": "Duval",
      "email": "sacha.duval@example.org" }
  ],
  "pagination": { "limit": 100, "offset": 0, "total": 2, "has_more": false }
}

# L'email est la clé de réconciliation la plus sûre : deux personnes peuvent
# être homonymes, elles ne partagent pas une adresse.
PERSON_ID=$(curl -sS -H "Authorization: Bearer $COMUSFLOW_TOKEN" \
  "https://app.comusflow.com/api/v1/ma-salle/people?limit=100" \
  | jq -r '.data[] | select(.email == "camille.blanc@example.org") | .id')

echo "person_id = $PERSON_ID"

export COMUSFLOW_TOKEN="cfat_…"

curl -sS -X POST \
  "https://app.comusflow.com/api/v1/ma-salle/people/314/contracts" \
  -H "Authorization: Bearer $COMUSFLOW_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -F "contract_type=cddu" \
  -F "title=CDDU novembre — régie lumière" \
  -F "period_start=2026-11-02" \
  -F "period_end=2026-11-08" \
  -F "file=@contrat-signe.pdf"

HTTP/1.1 201 Created

{
  "id": 1204,
  "person_id": 314,
  "contract_type": "cddu",
  "title": "CDDU novembre — régie lumière",
  "period_start": "2026-11-02",
  "period_end": "2026-11-08",
  "created_at": "2026-11-02T09:41:07Z"
}

import uuid
import requests

BASE = "https://app.comusflow.com/api/v1/ma-salle"
HEADERS = {"Authorization": f"Bearer {TOKEN}"}

# La clé identifie l'INTENTION, pas la tentative : on la calcule une fois,
# hors de la boucle de retry, sinon chaque nouvel essai crée un doublon.
key = str(uuid.uuid4())

with open("contrat-signe.pdf", "rb") as handle:
    response = requests.post(
        f"{BASE}/people/314/contracts",
        headers={**HEADERS, "Idempotency-Key": key},
        data={
            "contract_type": "cddu",
            "title": "CDDU novembre — régie lumière",
            "period_start": "2026-11-02",
            "period_end": "2026-11-08",
        },
        files={"file": ("contrat-signe.pdf", handle, "application/pdf")},
        timeout=30,
    )

response.raise_for_status()
if response.headers.get("Idempotency-Replayed") == "true":
    print("déjà déposé — rien n'a été exécuté cette fois-ci")
print(response.json()["id"])

HTTP/1.1 422 Unprocessable Entity

{
  "error": "Validation failed",
  "code": "INVALID_INPUT",
  "request_id": "5f2c…",
  "fields": {
    "period_end": ["La fin de période ne peut pas être antérieure à son début."]
  }
}

curl -sS -H "Authorization: Bearer $COMUSFLOW_TOKEN" \
  "https://app.comusflow.com/api/v1/ma-salle/people/314/contracts?limit=100" | jq

{
  "data": [
    {
      "id": 1204,
      "person_id": 314,
      "contract_type": "cddu",
      "title": "CDDU novembre — régie lumière",
      "period_start": "2026-11-02",
      "period_end": "2026-11-08",
      "created_at": "2026-11-02T09:41:07Z"
    }
  ],
  "pagination": { "limit": 100, "offset": 0, "total": 1, "has_more": false }
}

curl -sS -L -OJ \
  -H "Authorization: Bearer $COMUSFLOW_TOKEN" \
  "https://app.comusflow.com/api/v1/ma-salle/people/314/contracts/1204/download"

#!/usr/bin/env bash
# Dépose un contrat de travail, de bout en bout, sans doublon possible.
set -euo pipefail

: "${COMUSFLOW_TOKEN:?jeton absent}"
BASE="https://app.comusflow.com/api/v1/ma-salle"
AUTH=(-H "Authorization: Bearer $COMUSFLOW_TOKEN")

EMAIL="camille.blanc@example.org"
TYPE="cddu"
TITLE="CDDU novembre — régie lumière"
START="2026-11-02"
END="2026-11-08"
FILE="contrat-signe.pdf"

# 1. Résoudre la personne sur son email.
PERSON_ID=$(curl -sS "${AUTH[@]}" "$BASE/people?limit=100" \
  | jq -r --arg e "$EMAIL" '.data[] | select(.email == $e) | .id')
[ -n "$PERSON_ID" ] || { echo "personne introuvable : $EMAIL" >&2; exit 1; }

# 2. Une clé DÉRIVÉE de l'intention, pas tirée au hasard : relancer ce script
#    deux fois de suite ne peut alors pas créer deux contrats.
KEY=$(printf '%s|%s|%s|%s|%s' "$PERSON_ID" "$TYPE" "$TITLE" "$START" "$END" \
  | sha256sum | cut -d' ' -f1)

# 3. Déposer.
HTTP=$(curl -sS -o /tmp/contract.json -D /tmp/contract.headers -w '%{http_code}' \
  -X POST "$BASE/people/$PERSON_ID/contracts" \
  "${AUTH[@]}" -H "Idempotency-Key: $KEY" \
  -F "contract_type=$TYPE" -F "title=$TITLE" \
  -F "period_start=$START" -F "period_end=$END" \
  -F "file=@$FILE")

case "$HTTP" in
  201)
    if grep -qi '^idempotency-replayed: true' /tmp/contract.headers; then
      echo "déjà déposé — aucune écriture cette fois-ci"
    else
      echo "contrat déposé : $(jq -r .id /tmp/contract.json)"
    fi ;;
  409) echo "dépôt concurrent en cours, réessayez dans un instant" >&2; exit 75 ;;
  *)   echo "échec ($HTTP) : $(jq -r '.code // "?"' /tmp/contract.json)" >&2; exit 1 ;;
esac

# Parcourir tous les contrats d'une personne, page par page.
OFFSET=0
while : ; do
  PAGE=$(curl -sS "${AUTH[@]}" \
    "$BASE/people/$PERSON_ID/contracts?limit=100&offset=$OFFSET")
  echo "$PAGE" | jq -c '.data[]'
  TOTAL=$(echo "$PAGE" | jq -r '.pagination.total')
  OFFSET=$((OFFSET + 100))
  [ "$OFFSET" -lt "$TOTAL" ] || break
done