Développeurs

API SeveUp

Projets, maquettes IFC, révisions, contrôles IDS et exports de SeveUp App.

Télécharger le contrat OpenAPIOpenAPI 3.1 · v1.3.0

Voir en Markdown Ouvrir dans Claude Ouvrir dans ChatGPT

L'API est en service à l'adresse https://api.seve-up.app. Le contrat OpenAPI ci-dessous fait foi.

API publique de SeveUp App, réservée aux plans PRO, BUSINESS, ENTREPRISE et CUSTOM (TRIAL : lecture seule).

Authentification. Une clé d'organisation sk_…, créée dans la console d'organisation (section « Clés d'API »), envoyée en Authorization: Bearer sk_…. Chaque clé porte des scopes ; une route sans le scope requis répond 403 avec code: SCOPE_MISSING. Aucun secret n'est accepté dans une URL.

Erreurs. Toujours application/problem+json (RFC 9457). Le champ code est stable : le programme s'appuie dessus, jamais sur title ou detail. Le type s'en déduit (SCOPE_MISSING donne https://seve-up.com/problems/scope-missing). Une requête invalide (VALIDATION) détaille chaque champ fautif dans errors. Un identifiant inconnu, mal formé ou d'une autre organisation répond 404 NOT_FOUND.

Pagination. Par curseur opaque : ?limit= (1 à 200, 50 par défaut) et ?cursor= (valeur de next_cursor de la page précédente). Fin de liste : has_more: false et next_cursor: null.

Plans. L'API est ouverte aux plans PRO, BUSINESS, ENTREPRISE et CUSTOM. Le plan d'essai (TRIAL) l'ouvre en lecture seule : toute écriture répond 403 PLAN_READ_ONLY. Les autres plans répondent 403 PLAN_REQUIRED. Un plan payant arrivé à échéance reste lisible ; ses écritures répondent PLAN_READ_ONLY.

Débit. Chaque réponse porte RateLimit-Policy et RateLimit (draft-ietf-httpapi-ratelimit-headers), par clé et par fenêtre d'une minute : 60 requêtes en essai, 600 en PRO, 1 200 en BUSINESS, 3 000 en ENTREPRISE et CUSTOM. Au-delà : 429 RATE_LIMITED avec Retry-After en secondes.

Quotas. Par organisation et par mois calendaire (UTC) : appels, versions déposées, volume déposé, contrôles IDS. Un quota atteint répond 429 QUOTA_EXCEEDED, avec Retry-After jusqu'au 1er du mois suivant. Un quota se consomme avant le lancement du traitement : une requête refusée ne compte pas. Si la vérification est momentanément impossible, l'appel répond 503 BUSY plutôt que de passer sans être compté.

Capacité. Les opérations marquées x-heavy (dépôt, conversion, contrôle IDS, export, synthèses) partagent un nombre limité de places ; une organisation a au plus un nombre fixé de traitements actifs (3 en PRO, 5 en BUSINESS, 10 en ENTREPRISE et CUSTOM). Place indisponible : 503 BUSY avec Retry-After. Trop de traitements en cours : 429 QUOTA_EXCEEDED avec Retry-After.

Idempotence. Tout POST accepte Idempotency-Key (1 à 200 caractères, gardée 24 h par organisation). Rejouer la même clé avec le même corps renvoie la réponse d'origine et Idempotent-Replayed: true ; avec un autre corps, 409 IDEMPOTENCY_KEY_REUSED.

Traitements longs. Conversion d'une maquette, contrôle IDS et export répondent 202 avec une ressource Job ; suivre GET /api/v1/jobs/{job_id} ou s'abonner aux webhooks.

Types. Les nombres et booléens sont de vrais types JSON. Les dates sont en RFC 3339 (UTC).

Serveurs

https://api.seve-up.appProduction

Démarrer

De la clé au résultat d'un contrôle IDS, en sept appels. Les exemples utilisent curl et jq ; toute requête porte Authorization: Bearer suivi de la clé.

1.Créer une clé
Dans SeveUp App, console d'organisation, section « Clés d'API » (réservée aux administrateurs) : « Clé de l'API publique », cochez les scopes utiles (projects:read, models:read, models:write, ids:read, ids:write). Le secret sk_… n'est montré qu'une fois. La même section affiche l'usage de l'API : appels, quotas du mois et erreurs.
Shell
```
export SEVEUP_API=https://api.seve-up.app
export SEVEUP_KEY=sk_…   # clé d'organisation
```

2.Lister les projets

Réponse paginée par curseur : data, has_more, next_cursor.

Shell

curl -s "$SEVEUP_API/api/v1/projects" -H "Authorization: Bearer $SEVEUP_KEY" | jq '.data[] | {id, name}'

3.Ouvrir un dépôt

Le fichier ne passe pas par l'API : la réponse donne une adresse d'envoi TUS et ses en-têtes, valables 2 h. Idempotency-Key permet de rejouer l'appel sans créer un second dépôt.

Shell

FICHIER=maquette.ifc
TAILLE=$(wc -c < "$FICHIER")
curl -s -X POST "$SEVEUP_API/api/v1/uploads" \
  -H "Authorization: Bearer $SEVEUP_KEY" -H "Content-Type: application/json" \
  -H "Idempotency-Key: depot-$(date +%s)" \
  -d "{\"file_name\": \"$FICHIER\", \"size_bytes\": $TAILLE, \"purpose\": \"model\"}" > depot.json
DEPOT=$(jq -r .id depot.json)

4.Envoyer le fichier

Protocole TUS 1.0 : création, puis envoi des octets. Pour un gros fichier, préférez un client TUS (tus-js-client, tuspy…) qui reprend après une coupure, avec des morceaux de 6 Mo. Puis complete vérifie que le fichier est arrivé en entier.

Shell

URL=$(jq -r .upload_url depot.json)
AUTH=$(jq -r '.upload_headers.Authorization' depot.json)
META=$(jq -r '.upload_headers["Upload-Metadata"]' depot.json)
LOC=$(curl -s -i -X POST "$URL" -H "Authorization: $AUTH" -H "Tus-Resumable: 1.0.0" \
  -H "Upload-Metadata: $META" -H "Upload-Length: $TAILLE" \
  | awk 'tolower($1)=="location:" {print $2}' | tr -d '\r')
curl -s -X PATCH "$LOC" -H "Authorization: $AUTH" -H "Tus-Resumable: 1.0.0" \
  -H "Upload-Offset: 0" -H "Content-Type: application/offset+octet-stream" --data-binary @"$FICHIER"
curl -s -X POST "$SEVEUP_API/api/v1/uploads/$DEPOT/complete" \
  -H "Authorization: Bearer $SEVEUP_KEY" -H "Content-Type: application/json" -d '{}'

5.Créer la maquette

La conversion démarre aussitôt : réponse 202 avec un job, et son adresse dans Location. Pour une nouvelle version d'une maquette existante : POST /api/v1/models/{model_id}/revisions.

Shell

PROJET=…   # id d'un projet de l'étape 2
curl -s -X POST "$SEVEUP_API/api/v1/projects/$PROJET/models" \
  -H "Authorization: Bearer $SEVEUP_KEY" -H "Content-Type: application/json" \
  -d "{\"name\": \"Ma maquette\", \"upload_id\": \"$DEPOT\"}" > job.json
REVISION=$(jq -r .target.id job.json)

6.Suivre le traitement

Statuts : QUEUED, PROCESSING, puis COMPLETE ou ERROR (avec error.code). Plutôt que d'interroger, un webhook revision.processing.completed peut vous prévenir.

Shell

JOB=$(jq -r .id job.json)
until s=$(curl -s "$SEVEUP_API/api/v1/jobs/$JOB" -H "Authorization: Bearer $SEVEUP_KEY" | jq -r .status); \
  [ "$s" = COMPLETE ] || [ "$s" = ERROR ]; do sleep 20; done; echo "$s"

7.Contrôler avec un IDS et lire le résultat

Choisissez un jeu d'exigences existant, ou déposez un .ids (dépôt purpose: ids, puis POST /api/v1/requirement-sets). Le contrôle est un job comme les autres. Dans le résultat, une spécification compte dans le score si applicable est vrai.

Shell

JEU=$(curl -s "$SEVEUP_API/api/v1/requirement-sets" -H "Authorization: Bearer $SEVEUP_KEY" | jq -r '.data[0].id')
curl -s -X POST "$SEVEUP_API/api/v1/ids-checks" \
  -H "Authorization: Bearer $SEVEUP_KEY" -H "Content-Type: application/json" \
  -d "{\"revision_id\": \"$REVISION\", \"requirement_set_id\": \"$JEU\"}"
# … suivre le job comme à l'étape 6, puis :
curl -s "$SEVEUP_API/api/v1/revisions/$REVISION/ids-results" -H "Authorization: Bearer $SEVEUP_KEY" \
  | jq '.data[] | {score_percent, specification_count_failed}'

Erreurs

Toute erreur répond en application/problem+json (RFC 9457) : un code stable à tester dans votre code, un title lisible et, pour une requête invalide, la liste des champs en cause. La liste des codes peut s'allonger : traitez un code inconnu d'après le statut HTTP. Ces réponses valent pour la plupart des opérations ; chaque opération ne détaille que les siennes.

400Requête invalide.
401Clé absente, inconnue, expirée ou révoquée.
403Scope manquant (SCOPE_MISSING), plan sans accès à l'API (PLAN_REQUIRED), écriture refusée en plan TRIAL (PLAN_READ_ONLY) ou route non ouverte aux clés (API_KEY_ROUTE_FORBIDDEN).
404Ressource inexistante ou appartenant à une autre organisation (jamais distingué).
429Débit de la clé dépassé (RATE_LIMITED) ou quota mensuel du plan atteint (QUOTA_EXCEEDED).
500Erreur inattendue du serveur, déjà journalisée de notre côté ; réessayer plus tard.
503Capacité de traitement saturée pour l'instant ; réessayer après Retry-After.

Exemple de réponse d'erreur

{
  "type": "https://seve-up.com/problems/validation",
  "title": "Bad Request",
  "status": 400,
  "code": "VALIDATION",
  "detail": "limit : doit être compris entre 1 et 200.",
  "instance": "/api/v1/projects",
  "errors": [
    {
      "field": "limit",
      "message": "doit être compris entre 1 et 200"
    }
  ]
}

Projets

Projets de l'organisation visibles par la clé.

get/api/v1/projects
get/api/v1/projects/{project_id}

Lister les projets

get/api/v1/projects

Scope requis : projects:read

Paramètres

limit (query)integer
Taille de page.
cursor (query)string
Curseur opaque rendu par la page précédente (next_cursor).
q (query)string
Filtre sur le nom (contient, sans casse).

Réponses

200Une page de projets.Page & object

Erreurs communes :400 401 403 429 500 503(détail dans la section Erreurs)

curl -sS "$SEVEUP_API/api/v1/projects" \
  -H "Authorization: Bearer $SEVEUP_KEY"

Exemple (200)

{
  "data": [
    {
      "id": "5b0f3c3e-1d7a-4d0c-9a51-3f2b8f1e7a10",
      "name": "LNPCA — Section 1",
      "description": "Ligne nouvelle Provence Côte d'Azur",
      "space_id": "0b8a2c47-5a0e-4a7e-8f0d-0c6d2b7e9c31",
      "model_count": 197,
      "requirement_set_count": 4,
      "start_date": "2026-01-05T00:00:00Z",
      "end_date": null,
      "created_at": "2026-01-05T09:12:44Z",
      "updated_at": "2026-10-20T16:02:10Z"
    }
  ],
  "next_cursor": "eyJpZCI6IjViMGYzYzNlIn0",
  "has_more": true
}

Lire un projet

get/api/v1/projects/{project_id}

Scope requis : projects:read

Paramètres

project_id (path)string (uuid)requis
Identifiant du projet (id rendu par GET /api/v1/projects).

Réponses

200Le projet.Project

Erreurs communes :401 403 404 429 500 503(détail dans la section Erreurs)

curl -sS "$SEVEUP_API/api/v1/projects/$PROJECT_ID" \
  -H "Authorization: Bearer $SEVEUP_KEY"

Exemple (200)

{
  "id": "5b0f3c3e-1d7a-4d0c-9a51-3f2b8f1e7a10",
  "name": "LNPCA — Section 1",
  "description": "Ligne nouvelle Provence Côte d'Azur",
  "space_id": "0b8a2c47-5a0e-4a7e-8f0d-0c6d2b7e9c31",
  "model_count": 197,
  "requirement_set_count": 4,
  "start_date": "2026-01-05T00:00:00Z",
  "end_date": null,
  "created_at": "2026-01-05T09:12:44Z",
  "updated_at": "2026-10-20T16:02:10Z"
}

Maquettes

Maquettes IFC et leurs révisions.

get/api/v1/projects/{project_id}/models
post/api/v1/projects/{project_id}/models
get/api/v1/models/{model_id}
get/api/v1/models/{model_id}/revisions
post/api/v1/models/{model_id}/revisions
get/api/v1/revisions/{revision_id}

Lister les maquettes d'un projet

get/api/v1/projects/{project_id}/models

Scope requis : models:read

Paramètres

project_id (path)string (uuid)requis
Identifiant du projet (id rendu par GET /api/v1/projects).
limit (query)integer
Taille de page.
cursor (query)string
Curseur opaque rendu par la page précédente (next_cursor).

Réponses

200Une page de maquettes.Page & object

Erreurs communes :400 401 403 404 429 500 503(détail dans la section Erreurs)

curl -sS "$SEVEUP_API/api/v1/projects/$PROJECT_ID/models" \
  -H "Authorization: Bearer $SEVEUP_KEY"

Exemple (200)

{
  "data": [
    {
      "id": "9d2e7f10-6c4b-4f2a-8e11-2a7c5b3d9e01",
      "name": "LNPCA-S1-OA-PONT-0042",
      "format": "IFC",
      "revision_count": 3,
      "latest_revision_id": "4f6a1b2c-3d4e-4f50-8a6b-7c8d9e0f1a2b",
      "created_at": "2026-03-02T10:00:00Z",
      "updated_at": "2026-10-18T08:41:00Z"
    }
  ],
  "next_cursor": null,
  "has_more": false
}

Créer une maquette depuis un fichier déposé

post/api/v1/projects/{project_id}/models

Scope requis : models:write

Crée la maquette et sa première révision à partir d'un fichier déposé (POST /api/v1/uploads puis complete). La conversion démarre aussitôt : la réponse est le job de conversion.

Paramètres

project_id (path)string (uuid)requis
Identifiant du projet (id rendu par GET /api/v1/projects).
Idempotency-Key (header)string
Clé d'idempotence, gardée 24 h par organisation.

Corps de la requêteModelCreate

namestringrequis
upload_idstring (uuid)requis
Dépôt clos (purpose: model).

Réponses

202Traitement accepté ; suivre le job.Job
409Idempotency-Key déjà utilisée avec un autre corps, ou état incompatible.Problem

Erreurs communes :400 401 403 404 429 500 503(détail dans la section Erreurs)

curl -sS -X POST "$SEVEUP_API/api/v1/projects/$PROJECT_ID/models" \
  -H "Authorization: Bearer $SEVEUP_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "LNPCA-S1-OA-PONT-0042",
  "upload_id": "7a1c2e3f-4b5d-4e6f-8a9b-0c1d2e3f4a5b"
}'

Exemple (202)

{
  "id": "1f2e3d4c-5b6a-4978-8a1b-2c3d4e5f6a7b",
  "type": "conversion",
  "status": "QUEUED",
  "percent_complete": 0,
  "eta_seconds": null,
  "target": {
    "type": "revision",
    "id": "4f6a1b2c-3d4e-4f50-8a6b-7c8d9e0f1a2b"
  },
  "result": null,
  "error": null,
  "created_at": "2026-10-21T07:58:00Z",
  "started_at": null,
  "completed_at": null
}

Lire une maquette

get/api/v1/models/{model_id}

Scope requis : models:read

Paramètres

model_id (path)string (uuid)requis
Identifiant de la maquette (id rendu par la liste des maquettes du projet).

Réponses

200La maquette.Model

Erreurs communes :401 403 404 429 500 503(détail dans la section Erreurs)

curl -sS "$SEVEUP_API/api/v1/models/$MODEL_ID" \
  -H "Authorization: Bearer $SEVEUP_KEY"

Exemple (200)

{
  "id": "9d2e7f10-6c4b-4f2a-8e11-2a7c5b3d9e01",
  "name": "LNPCA-S1-OA-PONT-0042",
  "format": "IFC",
  "revision_count": 3,
  "latest_revision_id": "4f6a1b2c-3d4e-4f50-8a6b-7c8d9e0f1a2b",
  "created_at": "2026-03-02T10:00:00Z",
  "updated_at": "2026-10-18T08:41:00Z"
}

Lister les révisions d'une maquette

get/api/v1/models/{model_id}/revisions

Scope requis : models:read

Révisions de la plus récente à la plus ancienne.

Paramètres

model_id (path)string (uuid)requis
Identifiant de la maquette (id rendu par la liste des maquettes du projet).
limit (query)integer
Taille de page.
cursor (query)string
Curseur opaque rendu par la page précédente (next_cursor).

Réponses

200Une page de révisions.Page & object

Erreurs communes :400 401 403 404 429 500 503(détail dans la section Erreurs)

curl -sS "$SEVEUP_API/api/v1/models/$MODEL_ID/revisions" \
  -H "Authorization: Bearer $SEVEUP_KEY"

Exemple (200)

{
  "data": [
    {
      "id": "4f6a1b2c-3d4e-4f50-8a6b-7c8d9e0f1a2b",
      "model_id": "9d2e7f10-6c4b-4f2a-8e11-2a7c5b3d9e01",
      "version": 3,
      "file_name": "LNPCA-S1-OA-PONT-0042_C03.ifc",
      "size_bytes": 184467200,
      "ifc_schema": "IFC4X3_ADD2",
      "authoring_software": "Revit 2025",
      "status": "COMPLETE",
      "processing": {
        "conversion": {
          "status": "COMPLETE",
          "percent_complete": 100,
          "eta_seconds": null,
          "error_message": null
        },
        "dataset": {
          "status": "COMPLETE",
          "percent_complete": 100,
          "eta_seconds": null,
          "error_message": null
        },
        "scene": {
          "status": "COMPLETE",
          "percent_complete": 100,
          "eta_seconds": null,
          "error_message": null
        }
      },
      "object_count": 44213,
      "created_at": "2026-10-18T08:41:00Z"
    }
  ],
  "next_cursor": null,
  "has_more": false
}

Ajouter une révision depuis un fichier déposé

post/api/v1/models/{model_id}/revisions

Scope requis : models:write

Nouvelle version de la maquette. La conversion démarre aussitôt ; la réponse est le job.

Paramètres

model_id (path)string (uuid)requis
Identifiant de la maquette (id rendu par la liste des maquettes du projet).
Idempotency-Key (header)string
Clé d'idempotence, gardée 24 h par organisation.

Corps de la requêteRevisionCreate

upload_idstring (uuid)requis
milestonestring

Réponses

202Traitement accepté ; suivre le job.Job
409Idempotency-Key déjà utilisée avec un autre corps, ou état incompatible.Problem

Erreurs communes :400 401 403 404 429 500 503(détail dans la section Erreurs)

curl -sS -X POST "$SEVEUP_API/api/v1/models/$MODEL_ID/revisions" \
  -H "Authorization: Bearer $SEVEUP_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "upload_id": "7a1c2e3f-4b5d-4e6f-8a9b-0c1d2e3f4a5b",
  "milestone": "APD"
}'

Exemple (202)

{
  "id": "1f2e3d4c-5b6a-4978-8a1b-2c3d4e5f6a7b",
  "type": "conversion",
  "status": "QUEUED",
  "percent_complete": 0,
  "eta_seconds": null,
  "target": {
    "type": "revision",
    "id": "4f6a1b2c-3d4e-4f50-8a6b-7c8d9e0f1a2b"
  },
  "result": null,
  "error": null,
  "created_at": "2026-10-21T07:58:00Z",
  "started_at": null,
  "completed_at": null
}

Lire une révision et son état de traitement

get/api/v1/revisions/{revision_id}

Scope requis : models:read

Paramètres

revision_id (path)string (uuid)requis
Identifiant de la révision (latest_revision_id d'une maquette, ou id d'une révision).

Réponses

200La révision.Revision

Erreurs communes :401 403 404 429 500 503(détail dans la section Erreurs)

curl -sS "$SEVEUP_API/api/v1/revisions/$REVISION_ID" \
  -H "Authorization: Bearer $SEVEUP_KEY"

Exemple (200)

{
  "id": "4f6a1b2c-3d4e-4f50-8a6b-7c8d9e0f1a2b",
  "model_id": "9d2e7f10-6c4b-4f2a-8e11-2a7c5b3d9e01",
  "version": 3,
  "file_name": "LNPCA-S1-OA-PONT-0042_C03.ifc",
  "size_bytes": 184467200,
  "ifc_schema": "IFC4X3_ADD2",
  "authoring_software": "Revit 2025",
  "status": "PROCESSING",
  "processing": {
    "conversion": {
      "status": "COMPLETE",
      "percent_complete": 100,
      "eta_seconds": null,
      "error_message": null
    },
    "dataset": {
      "status": "PROCESSING",
      "percent_complete": 42,
      "eta_seconds": 180,
      "error_message": null
    },
    "scene": {
      "status": "QUEUED",
      "percent_complete": 0,
      "eta_seconds": null,
      "error_message": null
    }
  },
  "object_count": null,
  "created_at": "2026-10-18T08:41:00Z"
}

Fichiers

Dépôt de fichiers par URL signée, avant création d'une révision ou d'un jeu d'exigences.

post/api/v1/uploads
post/api/v1/uploads/{upload_id}/complete

Ouvrir un dépôt de fichier

post/api/v1/uploads

Scope requis : models:writeids:write

Renvoie un point d'entrée TUS (reprise possible) et les en-têtes à joindre à chaque requête TUS (Authorization, Tus-Resumable, Upload-Metadata). Le jeton de dépôt est valable 2 h (expires_at) : au-delà, ouvrir un nouveau dépôt. Le fichier ne transite pas par l'API. Une fois le fichier envoyé, appeler complete. Taille maximale selon le plan : 413 au-delà. Avec purpose: model, la clé doit porter models:write ; avec purpose: ids, ids:write. Extensions : .ifc pour une maquette, .ids ou .xlsx pour un jeu d'exigences.

Paramètres

Idempotency-Key (header)string
Clé d'idempotence, gardée 24 h par organisation.

Corps de la requêteUploadCreate

file_namestringrequis
size_bytesintegerrequis
Taille du fichier en octets. Au-delà de la limite du plan (3 Gio au plus), réponse 413.
purposestringrequis
model pour une maquette IFC, ids pour un jeu d'exigences.
Valeurs : model · ids

Réponses

201Dépôt ouvert.Upload
409Idempotency-Key déjà utilisée avec un autre corps, ou état incompatible.Problem
413Fichier plus gros que la limite du plan.Problem

Erreurs communes :400 401 403 429 500 503(détail dans la section Erreurs)

curl -sS -X POST "$SEVEUP_API/api/v1/uploads" \
  -H "Authorization: Bearer $SEVEUP_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "file_name": "LNPCA-S1-OA-PONT-0042_C03.ifc",
  "size_bytes": 184467200,
  "purpose": "model"
}'

Exemple (201)

{
  "id": "7a1c2e3f-4b5d-4e6f-8a9b-0c1d2e3f4a5b",
  "status": "PENDING",
  "file_name": "LNPCA-S1-OA-PONT-0042_C03.ifc",
  "size_bytes": 184467200,
  "purpose": "model",
  "upload_url": "https://ooddxuvlammhnltcfqpm.supabase.co/storage/v1/upload/resumable",
  "upload_headers": {
    "Authorization": "Bearer eyJhbGciOi…",
    "Tus-Resumable": "1.0.0",
    "Upload-Metadata": "bucketName YXR0YWNobWVudHM=,objectName …"
  },
  "expires_at": "2026-10-21T10:00:00Z"
}

Clore un dépôt de fichier

post/api/v1/uploads/{upload_id}/complete

Scope requis : models:writeids:write

Vérifie que le fichier est arrivé en entier (taille annoncée). L'empreinte MD5 fournie est conservée avec le fichier ; elle n'est pas recalculée. 409 si le fichier n'est pas encore complet ou si le dépôt a expiré. Rappeler complete sur un dépôt déjà clos renvoie le même résultat.

Paramètres

upload_id (path)string (uuid)requis
Identifiant du dépôt rendu par POST /api/v1/uploads.
Idempotency-Key (header)string
Clé d'idempotence, gardée 24 h par organisation.

Corps de la requête

md5_hexstring
Empreinte MD5 du fichier envoyé, conservée avec lui (non recalculée).

Réponses

200Dépôt clos ; le fichier peut servir à une maquette ou un jeu d'exigences.Upload
409Idempotency-Key déjà utilisée avec un autre corps, ou état incompatible.Problem

Erreurs communes :400 401 403 404 429 500 503(détail dans la section Erreurs)

curl -sS -X POST "$SEVEUP_API/api/v1/uploads/$UPLOAD_ID/complete" \
  -H "Authorization: Bearer $SEVEUP_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "md5_hex": "9e107d9d372bb6826bd81d3542a419d6"
}'

Exemple (200)

{
  "id": "7a1c2e3f-4b5d-4e6f-8a9b-0c1d2e3f4a5b",
  "status": "COMPLETE",
  "file_name": "LNPCA-S1-OA-PONT-0042_C03.ifc",
  "size_bytes": 184467200,
  "purpose": "model",
  "upload_url": null,
  "upload_headers": null,
  "expires_at": "2026-10-21T10:00:00Z"
}

IDS

Jeux d'exigences IDS et contrôles de conformité.

get/api/v1/revisions/{revision_id}/ids-results
get/api/v1/projects/{project_id}/ids-summary
get/api/v1/requirement-sets
post/api/v1/requirement-sets
post/api/v1/ids-checks

Résultats IDS d'une révision

get/api/v1/revisions/{revision_id}/ids-results

Scope requis : ids:read

Un résultat par jeu d'exigences lié à la révision, avec le détail par spécification. Une spécification est comptée dans le score si applicable est vrai. Une exigence de présence non satisfaite a applicable: true et entity_count_applicable: 0 : elle échoue, elle n'est pas « sans objet ».

Paramètres

revision_id (path)string (uuid)requis
Identifiant de la révision (latest_revision_id d'une maquette, ou id d'une révision).

Réponses

200Les résultats.object

Erreurs communes :401 403 404 429 500 503(détail dans la section Erreurs)

curl -sS "$SEVEUP_API/api/v1/revisions/$REVISION_ID/ids-results" \
  -H "Authorization: Bearer $SEVEUP_KEY"

Exemple (200)

{
  "data": [
    {
      "requirement_set_id": "2c3d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f",
      "requirement_set_revision_id": "3d4e5f6a-7b8c-4d9e-8f1a-2b3c4d5e6f70",
      "status": "COMPLETE",
      "score_percent": 87.5,
      "specification_count": 8,
      "specification_count_applicable": 8,
      "specification_count_failed": 1,
      "completed_at": "2026-10-18T09:02:11Z",
      "specifications": [
        {
          "index": 0,
          "name": "Classification des ouvrages d'art",
          "status": "PARTIAL",
          "applicable": true,
          "score_percent": 91.2,
          "entity_count_applicable": 1250,
          "entity_count_valid": 1140,
          "entity_count_invalid": 110
        },
        {
          "index": 1,
          "name": "Présence d'un IfcSite géoréférencé",
          "status": "FAIL",
          "applicable": true,
          "score_percent": 0,
          "entity_count_applicable": 0,
          "entity_count_valid": 0,
          "entity_count_invalid": 0
        }
      ]
    }
  ]
}

Synthèse IDS d'un projet (dernière révision de chaque maquette)

get/api/v1/projects/{project_id}/ids-summary

Scope requis : ids:read

Agrégé côté serveur ; une seule requête, quel que soit le nombre de maquettes.

Paramètres

project_id (path)string (uuid)requis
Identifiant du projet (id rendu par GET /api/v1/projects).

Réponses

200La synthèse.IdsSummary

Erreurs communes :401 403 404 429 500 503(détail dans la section Erreurs)

curl -sS "$SEVEUP_API/api/v1/projects/$PROJECT_ID/ids-summary" \
  -H "Authorization: Bearer $SEVEUP_KEY"

Exemple (200)

{
  "project_id": "5b0f3c3e-1d7a-4d0c-9a51-3f2b8f1e7a10",
  "model_count": 197,
  "model_count_checked": 190,
  "model_count_in_progress": 5,
  "model_count_error": 2,
  "score_percent": 82.4,
  "by_requirement_set": [
    {
      "requirement_set_id": "2c3d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f",
      "name": "Exigences BIM LNPCA v3",
      "model_count_checked": 190,
      "score_percent": 82.4
    }
  ],
  "computed_at": "2026-10-21T07:00:00Z"
}

Lister les jeux d'exigences IDS

get/api/v1/requirement-sets

Scope requis : ids:read

Paramètres

limit (query)integer
Taille de page.
cursor (query)string
Curseur opaque rendu par la page précédente (next_cursor).
project_id (query)string (uuid)
Jeux liés à ce projet seulement ; projet inconnu ou d'une autre organisation, 404.

Réponses

200Une page de jeux d'exigences.Page & object

Erreurs communes :400 401 403 404 429 500 503(détail dans la section Erreurs)

curl -sS "$SEVEUP_API/api/v1/requirement-sets" \
  -H "Authorization: Bearer $SEVEUP_KEY"

Exemple (200)

{
  "data": [
    {
      "id": "2c3d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f",
      "name": "Exigences BIM LNPCA v3",
      "format": "IDS",
      "scope": "PROJECT",
      "scope_id": "5b0f3c3e-1d7a-4d0c-9a51-3f2b8f1e7a10",
      "latest_revision_id": "3d4e5f6a-7b8c-4d9e-8f1a-2b3c4d5e6f70",
      "specification_count": 8,
      "created_at": "2026-02-10T14:00:00Z",
      "updated_at": "2026-09-30T11:20:00Z"
    }
  ],
  "next_cursor": null,
  "has_more": false
}

Créer un jeu d'exigences depuis un fichier IDS déposé

post/api/v1/requirement-sets

Scope requis : ids:write

Paramètres

Idempotency-Key (header)string
Clé d'idempotence, gardée 24 h par organisation.

Corps de la requêteRequirementSetCreate

namestringrequis
upload_idstring (uuid)requis
Dépôt clos (purpose: ids), fichier .ids ou .xlsx.
project_idstring (uuid)
Lie le jeu à ce projet ; sinon portée organisation.

Réponses

201Jeu créé.RequirementSet
409Idempotency-Key déjà utilisée avec un autre corps, ou état incompatible.Problem

Erreurs communes :400 401 403 429 500 503(détail dans la section Erreurs)

curl -sS -X POST "$SEVEUP_API/api/v1/requirement-sets" \
  -H "Authorization: Bearer $SEVEUP_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Exigences BIM LNPCA v3",
  "upload_id": "8b2d3f4a-5c6e-4f7a-9b0c-1d2e3f4a5b6c",
  "project_id": "5b0f3c3e-1d7a-4d0c-9a51-3f2b8f1e7a10"
}'

Exemple (201)

{
  "id": "2c3d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f",
  "name": "Exigences BIM LNPCA v3",
  "format": "IDS",
  "scope": "PROJECT",
  "scope_id": "5b0f3c3e-1d7a-4d0c-9a51-3f2b8f1e7a10",
  "latest_revision_id": "3d4e5f6a-7b8c-4d9e-8f1a-2b3c4d5e6f70",
  "specification_count": 8,
  "created_at": "2026-10-21T08:00:00Z",
  "updated_at": "2026-10-21T08:00:00Z"
}

Contrôler une révision avec un jeu d'exigences

post/api/v1/ids-checks

Scope requis : ids:write

Lance le contrôle (ou le relance si la paire a déjà un résultat). Si le jeu n'est rattaché ni à la maquette ni à un projet qui la contient, il est rattaché à la maquette, comme depuis l'application : ses autres révisions seront contrôlées aussi. Le jeu contrôlé est la version épinglée par le rattachement, sinon la dernière. Le résultat se lit ensuite dans GET /api/v1/revisions/{revision_id}/ids-results. Compte dans le quota mensuel de contrôles du plan. 400 si la révision ou le jeu est inconnu dans l'organisation, 409 si le jeu n'a aucune révision ou si la conversion de la révision a échoué.

Paramètres

Idempotency-Key (header)string
Clé d'idempotence, gardée 24 h par organisation.

Corps de la requêteIdsCheckCreate

revision_idstring (uuid)requis
requirement_set_idstring (uuid)requis

Réponses

202Traitement accepté ; suivre le job.Job
409Idempotency-Key déjà utilisée avec un autre corps, ou état incompatible.Problem

Erreurs communes :400 401 403 429 500 503(détail dans la section Erreurs)

curl -sS -X POST "$SEVEUP_API/api/v1/ids-checks" \
  -H "Authorization: Bearer $SEVEUP_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "revision_id": "4f6a1b2c-3d4e-4f50-8a6b-7c8d9e0f1a2b",
  "requirement_set_id": "2c3d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f"
}'

Exemple (202)

{
  "id": "1f2e3d4c-5b6a-4978-8a1b-2c3d4e5f6a7b",
  "type": "conversion",
  "status": "QUEUED",
  "percent_complete": 0,
  "eta_seconds": null,
  "target": {
    "type": "revision",
    "id": "4f6a1b2c-3d4e-4f50-8a6b-7c8d9e0f1a2b"
  },
  "result": null,
  "error": null,
  "created_at": "2026-10-21T07:58:00Z",
  "started_at": null,
  "completed_at": null
}

Exports

Export des données d'une révision.

post/api/v1/revisions/{revision_id}/exports

Exporter les données d'une révision

post/api/v1/revisions/{revision_id}/exports

Scope requis : exports:read

Prépare une archive zip, un fichier par table (CSV par défaut, ou JSON avec format: json). Le jeu de données de la révision doit être terminé (409 sinon). Quand le job est COMPLETE, son result donne une URL de téléchargement signée valable une heure, renouvelée à chaque lecture du job ; l'archive est gardée 48 h. Une table en échec est absente de l'archive et nommée dans error (code EXPORT_PARTIAL).

Paramètres

revision_id (path)string (uuid)requis
Identifiant de la révision (latest_revision_id d'une maquette, ou id d'une révision).
Idempotency-Key (header)string
Clé d'idempotence, gardée 24 h par organisation.

Corps de la requêteExportCreate

tablesstring[]
Tables à inclure ; toutes par défaut.
formatstring
Format des fichiers de l'archive.
Valeurs : csv · json

Réponses

202Traitement accepté ; suivre le job.Job
409Idempotency-Key déjà utilisée avec un autre corps, ou état incompatible.Problem

Erreurs communes :400 401 403 404 429 500 503(détail dans la section Erreurs)

curl -sS -X POST "$SEVEUP_API/api/v1/revisions/$REVISION_ID/exports" \
  -H "Authorization: Bearer $SEVEUP_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "tables": [
    "assets",
    "properties",
    "qto"
  ]
}'

Exemple (202)

{
  "id": "1f2e3d4c-5b6a-4978-8a1b-2c3d4e5f6a7b",
  "type": "conversion",
  "status": "QUEUED",
  "percent_complete": 0,
  "eta_seconds": null,
  "target": {
    "type": "revision",
    "id": "4f6a1b2c-3d4e-4f50-8a6b-7c8d9e0f1a2b"
  },
  "result": null,
  "error": null,
  "created_at": "2026-10-21T07:58:00Z",
  "started_at": null,
  "completed_at": null
}

Jobs

Suivi des traitements longs.

get/api/v1/jobs/{job_id}

Suivre un traitement long

get/api/v1/jobs/{job_id}

Scope requis : models:readids:readexports:read

Un job de conversion a pour identifiant celui de la révision ; son statut couvre conversion, jeu de données et scène. Scope exigé selon le type : models:read (conversion), ids:read (contrôle IDS), exports:read (export). Codes d'error : PROCESSING_FAILED, IDS_CHECK_FAILED, EXPORT_FAILED, EXPORT_EXPIRED, EXPORT_UNAVAILABLE, et EXPORT_PARTIAL sur un export COMPLETE dont des tables manquent.

Paramètres

job_id (path)string (uuid)requis
Identifiant du job, rendu par toute opération qui répond 202 (aussi dans l'en-tête Location).

Réponses

200Le job.Job

Erreurs communes :401 403 404 429 500 503(détail dans la section Erreurs)

curl -sS "$SEVEUP_API/api/v1/jobs/$JOB_ID" \
  -H "Authorization: Bearer $SEVEUP_KEY"

Exemple (200)

{
  "id": "1f2e3d4c-5b6a-4978-8a1b-2c3d4e5f6a7b",
  "type": "export",
  "status": "COMPLETE",
  "percent_complete": 100,
  "eta_seconds": null,
  "target": {
    "type": "revision",
    "id": "4f6a1b2c-3d4e-4f50-8a6b-7c8d9e0f1a2b"
  },
  "result": {
    "download_url": "https://ooddxuvlammhnltcfqpm.supabase.co/storage/v1/object/sign/exports/dataset-4f6a1b2c.zip?token=eyJhbGciOi",
    "download_expires_at": "2026-10-21T09:00:00Z",
    "size_bytes": 52428800
  },
  "error": null,
  "created_at": "2026-10-21T07:58:00Z",
  "started_at": "2026-10-21T07:58:02Z",
  "completed_at": "2026-10-21T07:59:40Z"
}

Webhooks

Abonnements aux événements de l'organisation.

get/api/v1/webhooks
post/api/v1/webhooks
delete/api/v1/webhooks/{webhook_id}
get/api/v1/webhooks/{webhook_id}/deliveries
post/api/v1/webhooks/{webhook_id}/deliveries/{delivery_id}/retry

Lister les abonnements webhook

get/api/v1/webhooks

Scope requis : webhooks:manage

Paramètres

limit (query)integer
Taille de page.
cursor (query)string
Curseur opaque rendu par la page précédente (next_cursor).

Réponses

200Une page d'abonnements.Page & object

Erreurs communes :400 401 403 429 500 503(détail dans la section Erreurs)

curl -sS "$SEVEUP_API/api/v1/webhooks" \
  -H "Authorization: Bearer $SEVEUP_KEY"

Exemple (200)

{
  "data": [
    {
      "id": "6e7f8a9b-0c1d-4e2f-8a3b-4c5d6e7f8a9b",
      "name": "ERP chantier",
      "url": "https://erp.example.com/hooks/seveup",
      "events": [
        "revision.processing.completed",
        "ids_check.completed"
      ],
      "active": true,
      "last_delivered_at": "2026-10-20T18:00:00Z",
      "last_status": 200,
      "created_at": "2026-09-01T10:00:00Z"
    }
  ],
  "next_cursor": null,
  "has_more": false
}

Créer un abonnement webhook

post/api/v1/webhooks

Scope requis : webhooks:manage

Le secret de signature n'est rendu qu'ici, une seule fois.

Paramètres

Idempotency-Key (header)string
Clé d'idempotence, gardée 24 h par organisation.

Corps de la requêteWebhookCreate

namestringrequis
urlstring (uri)requis
HTTPS uniquement, 2000 caractères au plus.
eventsWebhookEventType[]requis

Réponses

201Abonnement créé.Webhook & object
409Idempotency-Key déjà utilisée avec un autre corps, ou état incompatible.Problem

Erreurs communes :400 401 403 429 500 503(détail dans la section Erreurs)

curl -sS -X POST "$SEVEUP_API/api/v1/webhooks" \
  -H "Authorization: Bearer $SEVEUP_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "ERP chantier",
  "url": "https://erp.example.com/hooks/seveup",
  "events": [
    "revision.processing.completed",
    "ids_check.completed"
  ]
}'

Exemple (201)

{
  "id": "6e7f8a9b-0c1d-4e2f-8a3b-4c5d6e7f8a9b",
  "name": "ERP chantier",
  "url": "https://erp.example.com/hooks/seveup",
  "events": [
    "revision.processing.completed",
    "ids_check.completed"
  ],
  "active": true,
  "last_delivered_at": null,
  "last_status": null,
  "created_at": "2026-10-21T08:00:00Z",
  "secret": "whsec_<montré une seule fois>"
}

Supprimer un abonnement webhook

delete/api/v1/webhooks/{webhook_id}

Scope requis : webhooks:manage

Paramètres

webhook_id (path)string (uuid)requis
Identifiant de l'abonnement webhook.

Réponses

204Abonnement supprimé, avec son journal ; les livraisons en attente ne partent plus.

Erreurs communes :401 403 404 429 500 503(détail dans la section Erreurs)

curl -sS -X DELETE "$SEVEUP_API/api/v1/webhooks/$WEBHOOK_ID" \
  -H "Authorization: Bearer $SEVEUP_KEY"

Journal de livraison d'un abonnement

get/api/v1/webhooks/{webhook_id}/deliveries

Scope requis : webhooks:manage

Les livraisons des 30 derniers jours, les plus récentes d'abord.

Paramètres

webhook_id (path)string (uuid)requis
Identifiant de l'abonnement webhook.
limit (query)integer
Taille de page.
cursor (query)string
Curseur opaque rendu par la page précédente (next_cursor).

Réponses

200Une page de livraisons.Page & object

Erreurs communes :400 401 403 404 429 500 503(détail dans la section Erreurs)

curl -sS "$SEVEUP_API/api/v1/webhooks/$WEBHOOK_ID/deliveries" \
  -H "Authorization: Bearer $SEVEUP_KEY"

Exemple (200)

{
  "data": [
    {
      "id": "0b1c2d3e-4f50-4a6b-8c7d-9e0f1a2b3c4d",
      "event": "ids_check.completed",
      "status": "delivered",
      "attempts": 1,
      "response_code": 200,
      "error": null,
      "created_at": "2026-10-21T09:02:11Z",
      "delivered_at": "2026-10-21T09:02:12Z",
      "next_attempt_at": null
    }
  ],
  "next_cursor": null,
  "has_more": false
}

Rejouer une livraison

post/api/v1/webhooks/{webhook_id}/deliveries/{delivery_id}/retry

Scope requis : webhooks:manage

Remet la livraison en file, avec le même webhook-id : un destinataire qui l'avait déjà traitée la reconnaît. Une livraison encore en attente est rendue telle quelle. 409 si l'abonnement est désactivé ou si le corps de l'événement n'est plus conservé.

Paramètres

webhook_id (path)string (uuid)requis
Identifiant de l'abonnement webhook.
delivery_id (path)string (uuid)requis
Identifiant de la livraison, lu dans le journal de livraison de l'abonnement.
Idempotency-Key (header)string
Clé d'idempotence, gardée 24 h par organisation.

Réponses

202Livraison remise en file.WebhookDelivery
409Idempotency-Key déjà utilisée avec un autre corps, ou état incompatible.Problem

Erreurs communes :401 403 404 429 500 503(détail dans la section Erreurs)

curl -sS -X POST "$SEVEUP_API/api/v1/webhooks/$WEBHOOK_ID/deliveries/$DELIVERY_ID/retry" \
  -H "Authorization: Bearer $SEVEUP_KEY" \
  -H "Idempotency-Key: $(uuidgen)"

Exemple (202)

{
  "id": "0b1c2d3e-4f50-4a6b-8c7d-9e0f1a2b3c4d",
  "event": "ids_check.completed",
  "status": "pending",
  "attempts": 0,
  "response_code": 401,
  "error": "HTTP 401",
  "created_at": "2026-10-21T09:02:11Z",
  "delivered_at": null,
  "next_attempt_at": "2026-10-22T07:20:00Z"
}

Événements webhook

Événements envoyés en POST à l'URL d'un abonnement.

revision.processing.completed

Une révision est entièrement traitée

Livraison au format Standard Webhooks : en-têtes webhook-id (stable entre les essais), webhook-timestamp (secondes Unix) et webhook-signature (v1,<base64 HMAC-SHA256(clé, id.timestamp.corps)>, la clé étant le secret whsec_ décodé du base64). Les bibliothèques Standard Webhooks vérifient tout cela. Refuser un horodatage de plus de 5 minutes. Répondre 2xx en moins de 10 s ; sinon nouvel essai à délai croissant (1 min, 5 min, 30 min, 2 h), 5 essais en tout. Un 4xx autre que 408 et 429 arrête les essais ; une redirection n'est jamais suivie. job_id, quand il est présent, est celui que GET /api/v1/jobs/{job_id} suit.

Exemple

{
  "type": "revision.processing.completed",
  "timestamp": "2026-10-18T08:55:00Z",
  "data": {
    "revision_id": "4f6a1b2c-3d4e-4f50-8a6b-7c8d9e0f1a2b",
    "model_id": "9d2e7f10-6c4b-4f2a-8e11-2a7c5b3d9e01",
    "job_id": "4f6a1b2c-3d4e-4f50-8a6b-7c8d9e0f1a2b",
    "status": "COMPLETE"
  }
}

revision.processing.failed

Le traitement d'une révision a échoué

Envoyé quand une étape passe en ERROR, comme le montre GET /api/v1/revisions/{revision_id}. Une relance automatique qui réussit ensuite donne revision.processing.completed.

Exemple

{
  "type": "revision.processing.failed",
  "timestamp": "2026-10-18T08:55:00Z",
  "data": {
    "revision_id": "4f6a1b2c-3d4e-4f50-8a6b-7c8d9e0f1a2b",
    "model_id": "9d2e7f10-6c4b-4f2a-8e11-2a7c5b3d9e01",
    "job_id": "4f6a1b2c-3d4e-4f50-8a6b-7c8d9e0f1a2b",
    "status": "ERROR",
    "error_message": "Fichier IFC illisible"
  }
}

ids_check.completed

Un contrôle IDS est terminé

Exemple

{
  "type": "ids_check.completed",
  "timestamp": "2026-10-18T09:02:11Z",
  "data": {
    "revision_id": "4f6a1b2c-3d4e-4f50-8a6b-7c8d9e0f1a2b",
    "requirement_set_id": "2c3d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f",
    "requirement_revision_id": "3d4e5f6a-7b8c-4d9e-8f0a-1b2c3d4e5f6a",
    "job_id": "5e6f7a8b-9c0d-4e1f-8a2b-3c4d5e6f7a8b",
    "status": "COMPLETE",
    "score_percent": 87.5
  }
}

ids_check.failed

Un contrôle IDS a échoué

Exemple

{
  "type": "ids_check.failed",
  "timestamp": "2026-10-18T09:02:11Z",
  "data": {
    "revision_id": "4f6a1b2c-3d4e-4f50-8a6b-7c8d9e0f1a2b",
    "requirement_set_id": "2c3d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f",
    "requirement_revision_id": "3d4e5f6a-7b8c-4d9e-8f0a-1b2c3d4e5f6a",
    "status": "ERROR",
    "error_message": "Le contrôle n'a pas produit de résultat dans le délai"
  }
}

export.ready

Un export est prêt à télécharger

Exemple

{
  "type": "export.ready",
  "timestamp": "2026-10-21T07:59:40Z",
  "data": {
    "job_id": "1f2e3d4c-5b6a-4978-8a1b-2c3d4e5f6a7b",
    "revision_id": "4f6a1b2c-3d4e-4f50-8a6b-7c8d9e0f1a2b"
  }
}

Schémas

Problem object

Erreur RFC 9457.

typestring (uri)requis
titlestringrequis
statusintegerrequis
codestringrequis
Code stable, en majuscules. Liste ouverte : un nouveau code peut apparaître dans la v1 ; traiter un code inconnu d'après le statut HTTP.
Valeurs : VALIDATION · UNAUTHORIZED · INVALID_API_KEY · SCOPE_MISSING · API_KEY_ROUTE_FORBIDDEN · PLAN_REQUIRED · PLAN_READ_ONLY · NOT_FOUND · IDEMPOTENCY_KEY_REUSED · CONFLICT · FILE_TOO_LARGE · RATE_LIMITED · QUOTA_EXCEEDED · BUSY · INTERNAL_ERROR · GONE
detailstring
instancestring
errorsobject[]
Détail par champ, pour VALIDATION.

Page object

dataany[]requis
next_cursorstring | nullrequis
À passer en cursor pour la page suivante ; nul en fin de liste.
has_morebooleanrequis

ProcessingStatus string

STANDBY en attente d'un déclencheur, READY_FOR_PROCESSING prêt, QUEUED en file, PROCESSING en cours, COMPLETE terminé, ERROR en échec.

Valeurs : STANDBY · READY_FOR_PROCESSING · QUEUED · PROCESSING · COMPLETE · ERROR

Project object

idstring (uuid)requis
namestringrequis
descriptionstring | null
space_idstring (uuid) | null
Espace (regroupement de projets) qui contient le projet.
model_countinteger
requirement_set_countinteger
start_datestring (date-time) | null
end_datestring (date-time) | null
created_atstring (date-time)requis
updated_atstring (date-time)requis

Model object

idstring (uuid)requis
namestringrequis
formatstringrequis
Valeurs : IFC · REVIT
revision_countintegerrequis
latest_revision_idstring (uuid) | null
created_atstring (date-time)requis
updated_atstring (date-time)requis

ModelCreate object

namestringrequis
upload_idstring (uuid)requis
Dépôt clos (purpose: model).

StepStatus object

statusProcessingStatusrequis
percent_completenumber | null
eta_secondsnumber | null
error_messagestring | null

Revision object

idstring (uuid)requis
model_idstring (uuid)requis
versionintegerrequis
milestonestring | null
Jalon (APS, APD, PRO, EXE…).
file_namestring | null
size_bytesinteger | null
ifc_schemastring | null
Ex. IFC2X3, IFC4, IFC4X3_ADD2.
authoring_softwarestring | null
statusProcessingStatusrequis
État global, le moins avancé des étapes.
processingobjectrequis
object_countinteger | null
Nombre d'objets du jeu de données ; nul tant que dataset n'est pas COMPLETE.
created_atstring (date-time)requis

RevisionCreate object

upload_idstring (uuid)requis
milestonestring

IdsSpecificationResult object

indexintegerrequis
namestringrequis
statusstringrequis
NA : sans objet pour cette maquette, non compté dans le score.
Valeurs : PASS · PARTIAL · FAIL · NA · MISMATCH
applicablebooleanrequis
Compté dans le score. Seul critère d'applicabilité, jamais entity_count_applicable > 0.
score_percentnumber | null
entity_count_applicableinteger
entity_count_validinteger
entity_count_invalidinteger

IdsResult object

requirement_set_idstring (uuid)requis
requirement_set_revision_idstring (uuid)requis
statusProcessingStatusrequis
score_percentnumber | null
specification_countinteger | null
specification_count_applicableinteger | null
specification_count_failedinteger | null
completed_atstring (date-time) | null
specificationsIdsSpecificationResult[]
Vide tant que status n'est pas COMPLETE.

IdsSummary object

project_idstring (uuid)requis
model_countintegerrequis
model_count_checkedinteger
model_count_in_progressinteger
model_count_errorinteger
score_percentnumber | null
Moyenne des maquettes contrôlées ; nul si aucune.
by_requirement_setobject[]
computed_atstring (date-time)requis

RequirementSet object

idstring (uuid)requis
namestringrequis
formatstringrequis
Valeurs : IDS · SEVEUP
scopestringrequis
Portée du jeu (organisation, espace ou projet).
Valeurs : ORGANIZATION · SPACE · PROJECT
scope_idstring (uuid) | null
latest_revision_idstring (uuid) | null
specification_countinteger | null
created_atstring (date-time)requis
updated_atstring (date-time)requis

RequirementSetCreate object

namestringrequis
upload_idstring (uuid)requis
Dépôt clos (purpose: ids), fichier .ids ou .xlsx.
project_idstring (uuid)
Lie le jeu à ce projet ; sinon portée organisation.

IdsCheckCreate object

revision_idstring (uuid)requis
requirement_set_idstring (uuid)requis

ExportCreate object

tablesstring[]
Tables à inclure ; toutes par défaut.
formatstring
Format des fichiers de l'archive.
Valeurs : csv · json

UploadCreate object

file_namestringrequis
size_bytesintegerrequis
Taille du fichier en octets. Au-delà de la limite du plan (3 Gio au plus), réponse 413.
purposestringrequis
model pour une maquette IFC, ids pour un jeu d'exigences.
Valeurs : model · ids

Upload object

idstring (uuid)requis
statusstringrequis
Valeurs : PENDING · COMPLETE
file_namestringrequis
size_bytesintegerrequis
purposestringrequis
Valeurs : model · ids
upload_urlstring (uri) | null
Point d'entrée TUS ; nul une fois le dépôt clos.
upload_headersobject | null
En-têtes à joindre aux requêtes TUS.
expires_atstring (date-time)requis

Job object

idstring (uuid)requis
typestringrequis
Valeurs : conversion · ids_check · export
statusProcessingStatusrequis
percent_completenumber | null
eta_secondsnumber | null
targetobjectrequis
resultobject | null
Export : URL signée et taille. Conversion et contrôle IDS : nul, lire la révision ou ses résultats IDS.
errorobject | null
created_atstring (date-time)requis
started_atstring (date-time) | null
completed_atstring (date-time) | null

WebhookEventType string

Valeurs : revision.processing.completed · revision.processing.failed · ids_check.completed · ids_check.failed · export.ready

Webhook object

idstring (uuid)requis
namestringrequis
urlstring (uri)requis
eventsWebhookEventType[]requis
activebooleanrequis
last_delivered_atstring (date-time) | null
last_statusinteger | null
created_atstring (date-time)requis

WebhookCreate object

namestringrequis
urlstring (uri)requis
HTTPS uniquement, 2000 caractères au plus.
eventsWebhookEventType[]requis

WebhookDelivery object

idstring (uuid)requis
Valeur de l'en-tête webhook-id.
eventstringrequis
statusstringrequis
pending en file ou en attente d'un nouvel essai ; delivered reçu en 2xx ; failed refusé par le destinataire (4xx) ; abandoned essais épuisés ou abonnement supprimé ; refused URL non publique.
Valeurs : pending · delivered · failed · abandoned · refused
attemptsintegerrequis
response_codeinteger | null
errorstring | null
created_atstring (date-time)requis
delivered_atstring (date-time) | null
next_attempt_atstring (date-time) | null

WebhookEvent object

typeWebhookEventTyperequis
timestampstring (date-time)requis
dataobjectrequis

Versions et dépréciation

La version majeure est dans le chemin : /api/v1. À l'intérieur d'une version, seuls des changements compatibles sont publiés : nouvelles opérations, nouveaux champs de réponse, nouveaux paramètres facultatifs. Votre code doit ignorer les champs qu'il ne connaît pas et traiter un code d'erreur inconnu d'après le statut HTTP : la liste des codes peut s'allonger.
Un changement incompatible (champ retiré ou renommé, type modifié, paramètre rendu obligatoire) passe par une nouvelle version, /api/v2. La version précédente reste servie au moins 12 mois après la sortie de la suivante.
Dans v1, un champ n'est jamais retiré. Une opération vouée à disparaître est annoncée au moins 6 mois avant son retrait : entrée dans le journal des changements (aussi en flux Atom), e-mail aux administrateurs des organisations dont une clé l'a appelée dans les 90 derniers jours, 6 mois puis 1 mois avant le retrait, et en-têtes Deprecation (RFC 9745), Sunset (RFC 8594) et Link (rel="deprecation", vers le journal) sur ses réponses. Elle fonctionne normalement jusqu'à la date de retrait, puis répond 410 avec le code GONE.
Seule exception : un correctif de sécurité peut s'appliquer sans préavis. Il est alors décrit dans le journal des changements le jour même.

Journal des changements

Version JSON Flux Atom Cette page en Markdown (pour les agents IA)

2026-10-22 · v1.3.0
Nouveau statut d'erreur documenté : GET /api/v1/requirement-sets.
1 changement(s) en détail
- GET /api/v1/requirement-setsNouveau statut d'erreur documenté `404`
2026-10-22 · v1.2.0
Codes d'erreur : la liste de `code` devient ouverte (`x-extensible-enum`), un code inconnu se traite d'après le statut HTTP. Nouveau code `GONE` et réponse `410` pour une opération retirée à sa date `x-sunset`, annoncée au moins 6 mois avant par les en-têtes `Deprecation` et `Sunset`.
2 changement(s) en détail
- Liste ouverte des codes d'erreur `code`
- Nouvelle valeur possible dans la réponse `GONE`
2026-10-22 · v1.1.0
Nouvel en-tête de réponse documenté (22 opérations) ; Format d'en-tête de réponse précisé (22 opérations) ; Nouveau statut d'erreur documenté (22 opérations) ; Format de champ de réponse précisé (22 opérations).
312 changement(s) en détail
- POST /api/v1/ids-checksNouvel en-tête de réponse documenté `ratelimit`
- POST /api/v1/ids-checksNouvel en-tête de réponse documenté `ratelimit`
- POST /api/v1/ids-checksNouvel en-tête de réponse documenté `ratelimit-policy`
- POST /api/v1/ids-checksNouvel en-tête de réponse documenté `ratelimit-policy`
- POST /api/v1/ids-checksFormat d'en-tête de réponse précisé `retry-after`
- POST /api/v1/ids-checksFormat d'en-tête de réponse précisé `retry-after`
- POST /api/v1/ids-checksNouveau statut d'erreur documenté `500`
- POST /api/v1/ids-checksFormat de champ de réponse précisé `result/size_bytes`
- POST /api/v1/ids-checksFormat de champ de réponse précisé `status`
- POST /api/v1/ids-checksFormat de champ de réponse précisé `status`
- POST /api/v1/ids-checksFormat de champ de réponse précisé `status`
- POST /api/v1/ids-checksFormat de champ de réponse précisé `status`
- POST /api/v1/ids-checksFormat de champ de réponse précisé `status`
- POST /api/v1/ids-checksFormat de champ de réponse précisé `status`
- GET /api/v1/jobs/{job_id}Nouvel en-tête de réponse documenté `ratelimit`
- GET /api/v1/jobs/{job_id}Nouvel en-tête de réponse documenté `ratelimit-policy`
- GET /api/v1/jobs/{job_id}Format d'en-tête de réponse précisé `retry-after`
- GET /api/v1/jobs/{job_id}Format d'en-tête de réponse précisé `retry-after`
- GET /api/v1/jobs/{job_id}Nouveau statut d'erreur documenté `500`
- GET /api/v1/jobs/{job_id}Format de champ de réponse précisé `result/size_bytes`
- GET /api/v1/jobs/{job_id}Format de champ de réponse précisé `status`
- GET /api/v1/jobs/{job_id}Format de champ de réponse précisé `status`
- GET /api/v1/jobs/{job_id}Format de champ de réponse précisé `status`
- GET /api/v1/jobs/{job_id}Format de champ de réponse précisé `status`
- GET /api/v1/jobs/{job_id}Format de champ de réponse précisé `status`
- GET /api/v1/models/{model_id}Nouvel en-tête de réponse documenté `ratelimit`
- GET /api/v1/models/{model_id}Nouvel en-tête de réponse documenté `ratelimit-policy`
- GET /api/v1/models/{model_id}Format d'en-tête de réponse précisé `retry-after`
- GET /api/v1/models/{model_id}Format d'en-tête de réponse précisé `retry-after`
- GET /api/v1/models/{model_id}Nouveau statut d'erreur documenté `500`
- GET /api/v1/models/{model_id}Format de champ de réponse précisé `revision_count`
- GET /api/v1/models/{model_id}Format de champ de réponse précisé `status`
- GET /api/v1/models/{model_id}Format de champ de réponse précisé `status`
- GET /api/v1/models/{model_id}Format de champ de réponse précisé `status`
- GET /api/v1/models/{model_id}Format de champ de réponse précisé `status`
- GET /api/v1/models/{model_id}Format de champ de réponse précisé `status`
- GET /api/v1/models/{model_id}/revisionsNouvel en-tête de réponse documenté `ratelimit`
- GET /api/v1/models/{model_id}/revisionsNouvel en-tête de réponse documenté `ratelimit`
- GET /api/v1/models/{model_id}/revisionsNouvel en-tête de réponse documenté `ratelimit-policy`
- GET /api/v1/models/{model_id}/revisionsNouvel en-tête de réponse documenté `ratelimit-policy`
- GET /api/v1/models/{model_id}/revisionsFormat d'en-tête de réponse précisé `retry-after`
- GET /api/v1/models/{model_id}/revisionsFormat d'en-tête de réponse précisé `retry-after`
- GET /api/v1/models/{model_id}/revisionsNouveau statut d'erreur documenté `500`
- GET /api/v1/models/{model_id}/revisionsFormat de champ de réponse précisé `data/items/object_count`
- GET /api/v1/models/{model_id}/revisionsFormat de champ de réponse précisé `data/items/size_bytes`
- GET /api/v1/models/{model_id}/revisionsFormat de champ de réponse précisé `data/items/version`
- GET /api/v1/models/{model_id}/revisionsFormat de champ de réponse précisé `status`
- GET /api/v1/models/{model_id}/revisionsFormat de champ de réponse précisé `status`
- GET /api/v1/models/{model_id}/revisionsFormat de champ de réponse précisé `status`
- GET /api/v1/models/{model_id}/revisionsFormat de champ de réponse précisé `status`
- GET /api/v1/models/{model_id}/revisionsFormat de champ de réponse précisé `status`
- GET /api/v1/models/{model_id}/revisionsFormat de champ de réponse précisé `status`
- POST /api/v1/models/{model_id}/revisionsNouvel en-tête de réponse documenté `ratelimit`
- POST /api/v1/models/{model_id}/revisionsNouvel en-tête de réponse documenté `ratelimit`
- POST /api/v1/models/{model_id}/revisionsNouvel en-tête de réponse documenté `ratelimit`
- POST /api/v1/models/{model_id}/revisionsNouvel en-tête de réponse documenté `ratelimit-policy`
- POST /api/v1/models/{model_id}/revisionsNouvel en-tête de réponse documenté `ratelimit-policy`
- POST /api/v1/models/{model_id}/revisionsNouvel en-tête de réponse documenté `ratelimit-policy`
- POST /api/v1/models/{model_id}/revisionsFormat d'en-tête de réponse précisé `retry-after`
- POST /api/v1/models/{model_id}/revisionsFormat d'en-tête de réponse précisé `retry-after`
- POST /api/v1/models/{model_id}/revisionsNouveau statut d'erreur documenté `500`
- POST /api/v1/models/{model_id}/revisionsFormat de champ de réponse précisé `result/size_bytes`
- POST /api/v1/models/{model_id}/revisionsFormat de champ de réponse précisé `status`
- POST /api/v1/models/{model_id}/revisionsFormat de champ de réponse précisé `status`
- POST /api/v1/models/{model_id}/revisionsFormat de champ de réponse précisé `status`
- POST /api/v1/models/{model_id}/revisionsFormat de champ de réponse précisé `status`
- POST /api/v1/models/{model_id}/revisionsFormat de champ de réponse précisé `status`
- POST /api/v1/models/{model_id}/revisionsFormat de champ de réponse précisé `status`
- POST /api/v1/models/{model_id}/revisionsFormat de champ de réponse précisé `status`
- GET /api/v1/projectsNouvel en-tête de réponse documenté `ratelimit`
- GET /api/v1/projectsNouvel en-tête de réponse documenté `ratelimit-policy`
- GET /api/v1/projectsFormat d'en-tête de réponse précisé `retry-after`
- GET /api/v1/projectsFormat d'en-tête de réponse précisé `retry-after`
- GET /api/v1/projectsNouveau statut d'erreur documenté `500`
- GET /api/v1/projectsFormat de champ de réponse précisé `data/items/model_count`
- GET /api/v1/projectsFormat de champ de réponse précisé `data/items/requirement_set_count`
- GET /api/v1/projectsFormat de champ de réponse précisé `status`
- GET /api/v1/projectsFormat de champ de réponse précisé `status`
- GET /api/v1/projectsFormat de champ de réponse précisé `status`
- GET /api/v1/projectsFormat de champ de réponse précisé `status`
- GET /api/v1/projectsFormat de champ de réponse précisé `status`
- GET /api/v1/projects/{project_id}Nouvel en-tête de réponse documenté `ratelimit`
- GET /api/v1/projects/{project_id}Nouvel en-tête de réponse documenté `ratelimit-policy`
- GET /api/v1/projects/{project_id}Format d'en-tête de réponse précisé `retry-after`
- GET /api/v1/projects/{project_id}Format d'en-tête de réponse précisé `retry-after`
- GET /api/v1/projects/{project_id}Nouveau statut d'erreur documenté `500`
- GET /api/v1/projects/{project_id}Format de champ de réponse précisé `model_count`
- GET /api/v1/projects/{project_id}Format de champ de réponse précisé `requirement_set_count`
- GET /api/v1/projects/{project_id}Format de champ de réponse précisé `status`
- GET /api/v1/projects/{project_id}Format de champ de réponse précisé `status`
- GET /api/v1/projects/{project_id}Format de champ de réponse précisé `status`
- GET /api/v1/projects/{project_id}Format de champ de réponse précisé `status`
- GET /api/v1/projects/{project_id}Format de champ de réponse précisé `status`
- GET /api/v1/projects/{project_id}/ids-summaryNouvel en-tête de réponse documenté `ratelimit`
- GET /api/v1/projects/{project_id}/ids-summaryNouvel en-tête de réponse documenté `ratelimit-policy`
- GET /api/v1/projects/{project_id}/ids-summaryFormat d'en-tête de réponse précisé `retry-after`
- GET /api/v1/projects/{project_id}/ids-summaryFormat d'en-tête de réponse précisé `retry-after`
- GET /api/v1/projects/{project_id}/ids-summaryNouveau statut d'erreur documenté `500`
- GET /api/v1/projects/{project_id}/ids-summaryFormat de champ de réponse précisé `by_requirement_set/items/model_count_checked`
- GET /api/v1/projects/{project_id}/ids-summaryFormat de champ de réponse précisé `model_count`
- GET /api/v1/projects/{project_id}/ids-summaryFormat de champ de réponse précisé `model_count_checked`
- GET /api/v1/projects/{project_id}/ids-summaryFormat de champ de réponse précisé `model_count_error`
- GET /api/v1/projects/{project_id}/ids-summaryFormat de champ de réponse précisé `model_count_in_progress`
- GET /api/v1/projects/{project_id}/ids-summaryFormat de champ de réponse précisé `status`
- GET /api/v1/projects/{project_id}/ids-summaryFormat de champ de réponse précisé `status`
- GET /api/v1/projects/{project_id}/ids-summaryFormat de champ de réponse précisé `status`
- GET /api/v1/projects/{project_id}/ids-summaryFormat de champ de réponse précisé `status`
- GET /api/v1/projects/{project_id}/ids-summaryFormat de champ de réponse précisé `status`
- GET /api/v1/projects/{project_id}/modelsNouvel en-tête de réponse documenté `ratelimit`
- GET /api/v1/projects/{project_id}/modelsNouvel en-tête de réponse documenté `ratelimit`
- GET /api/v1/projects/{project_id}/modelsNouvel en-tête de réponse documenté `ratelimit-policy`
- GET /api/v1/projects/{project_id}/modelsNouvel en-tête de réponse documenté `ratelimit-policy`
- GET /api/v1/projects/{project_id}/modelsFormat d'en-tête de réponse précisé `retry-after`
- GET /api/v1/projects/{project_id}/modelsFormat d'en-tête de réponse précisé `retry-after`
- GET /api/v1/projects/{project_id}/modelsNouveau statut d'erreur documenté `500`
- GET /api/v1/projects/{project_id}/modelsFormat de champ de réponse précisé `data/items/revision_count`
- GET /api/v1/projects/{project_id}/modelsFormat de champ de réponse précisé `status`
- GET /api/v1/projects/{project_id}/modelsFormat de champ de réponse précisé `status`
- GET /api/v1/projects/{project_id}/modelsFormat de champ de réponse précisé `status`
- GET /api/v1/projects/{project_id}/modelsFormat de champ de réponse précisé `status`
- GET /api/v1/projects/{project_id}/modelsFormat de champ de réponse précisé `status`
- GET /api/v1/projects/{project_id}/modelsFormat de champ de réponse précisé `status`
- POST /api/v1/projects/{project_id}/modelsNouvel en-tête de réponse documenté `ratelimit`
- POST /api/v1/projects/{project_id}/modelsNouvel en-tête de réponse documenté `ratelimit`
- POST /api/v1/projects/{project_id}/modelsNouvel en-tête de réponse documenté `ratelimit`
- POST /api/v1/projects/{project_id}/modelsNouvel en-tête de réponse documenté `ratelimit-policy`
- POST /api/v1/projects/{project_id}/modelsNouvel en-tête de réponse documenté `ratelimit-policy`
- POST /api/v1/projects/{project_id}/modelsNouvel en-tête de réponse documenté `ratelimit-policy`
- POST /api/v1/projects/{project_id}/modelsFormat d'en-tête de réponse précisé `retry-after`
- POST /api/v1/projects/{project_id}/modelsFormat d'en-tête de réponse précisé `retry-after`
- POST /api/v1/projects/{project_id}/modelsNouveau statut d'erreur documenté `500`
- POST /api/v1/projects/{project_id}/modelsFormat de champ de réponse précisé `result/size_bytes`
- POST /api/v1/projects/{project_id}/modelsFormat de champ de réponse précisé `status`
- POST /api/v1/projects/{project_id}/modelsFormat de champ de réponse précisé `status`
- POST /api/v1/projects/{project_id}/modelsFormat de champ de réponse précisé `status`
- POST /api/v1/projects/{project_id}/modelsFormat de champ de réponse précisé `status`
- POST /api/v1/projects/{project_id}/modelsFormat de champ de réponse précisé `status`
- POST /api/v1/projects/{project_id}/modelsFormat de champ de réponse précisé `status`
- POST /api/v1/projects/{project_id}/modelsFormat de champ de réponse précisé `status`
- GET /api/v1/requirement-setsNouvel en-tête de réponse documenté `ratelimit`
- GET /api/v1/requirement-setsNouvel en-tête de réponse documenté `ratelimit-policy`
- GET /api/v1/requirement-setsFormat d'en-tête de réponse précisé `retry-after`
- GET /api/v1/requirement-setsFormat d'en-tête de réponse précisé `retry-after`
- GET /api/v1/requirement-setsNouveau statut d'erreur documenté `500`
- GET /api/v1/requirement-setsFormat de champ de réponse précisé `data/items/specification_count`
- GET /api/v1/requirement-setsFormat de champ de réponse précisé `status`
- GET /api/v1/requirement-setsFormat de champ de réponse précisé `status`
- GET /api/v1/requirement-setsFormat de champ de réponse précisé `status`
- GET /api/v1/requirement-setsFormat de champ de réponse précisé `status`
- GET /api/v1/requirement-setsFormat de champ de réponse précisé `status`
- POST /api/v1/requirement-setsNouvel en-tête de réponse documenté `ratelimit`
- POST /api/v1/requirement-setsNouvel en-tête de réponse documenté `ratelimit`
- POST /api/v1/requirement-setsNouvel en-tête de réponse documenté `ratelimit-policy`
- POST /api/v1/requirement-setsNouvel en-tête de réponse documenté `ratelimit-policy`
- POST /api/v1/requirement-setsFormat d'en-tête de réponse précisé `retry-after`
- POST /api/v1/requirement-setsFormat d'en-tête de réponse précisé `retry-after`
- POST /api/v1/requirement-setsNouveau statut d'erreur documenté `500`
- POST /api/v1/requirement-setsFormat de champ de réponse précisé `specification_count`
- POST /api/v1/requirement-setsFormat de champ de réponse précisé `status`
- POST /api/v1/requirement-setsFormat de champ de réponse précisé `status`
- POST /api/v1/requirement-setsFormat de champ de réponse précisé `status`
- POST /api/v1/requirement-setsFormat de champ de réponse précisé `status`
- POST /api/v1/requirement-setsFormat de champ de réponse précisé `status`
- POST /api/v1/requirement-setsFormat de champ de réponse précisé `status`
- GET /api/v1/revisions/{revision_id}Nouvel en-tête de réponse documenté `ratelimit`
- GET /api/v1/revisions/{revision_id}Nouvel en-tête de réponse documenté `ratelimit-policy`
- GET /api/v1/revisions/{revision_id}Format d'en-tête de réponse précisé `retry-after`
- GET /api/v1/revisions/{revision_id}Format d'en-tête de réponse précisé `retry-after`
- GET /api/v1/revisions/{revision_id}Nouveau statut d'erreur documenté `500`
- GET /api/v1/revisions/{revision_id}Format de champ de réponse précisé `object_count`
- GET /api/v1/revisions/{revision_id}Format de champ de réponse précisé `size_bytes`
- GET /api/v1/revisions/{revision_id}Format de champ de réponse précisé `status`
- GET /api/v1/revisions/{revision_id}Format de champ de réponse précisé `status`
- GET /api/v1/revisions/{revision_id}Format de champ de réponse précisé `status`
- GET /api/v1/revisions/{revision_id}Format de champ de réponse précisé `status`
- GET /api/v1/revisions/{revision_id}Format de champ de réponse précisé `status`
- GET /api/v1/revisions/{revision_id}Format de champ de réponse précisé `version`
- POST /api/v1/revisions/{revision_id}/exportsNouvel en-tête de réponse documenté `ratelimit`
- POST /api/v1/revisions/{revision_id}/exportsNouvel en-tête de réponse documenté `ratelimit`
- POST /api/v1/revisions/{revision_id}/exportsNouvel en-tête de réponse documenté `ratelimit`
- POST /api/v1/revisions/{revision_id}/exportsNouvel en-tête de réponse documenté `ratelimit-policy`
- POST /api/v1/revisions/{revision_id}/exportsNouvel en-tête de réponse documenté `ratelimit-policy`
- POST /api/v1/revisions/{revision_id}/exportsNouvel en-tête de réponse documenté `ratelimit-policy`
- POST /api/v1/revisions/{revision_id}/exportsFormat d'en-tête de réponse précisé `retry-after`
- POST /api/v1/revisions/{revision_id}/exportsFormat d'en-tête de réponse précisé `retry-after`
- POST /api/v1/revisions/{revision_id}/exportsNouveau statut d'erreur documenté `500`
- POST /api/v1/revisions/{revision_id}/exportsFormat de champ de réponse précisé `result/size_bytes`
- POST /api/v1/revisions/{revision_id}/exportsFormat de champ de réponse précisé `status`
- POST /api/v1/revisions/{revision_id}/exportsFormat de champ de réponse précisé `status`
- POST /api/v1/revisions/{revision_id}/exportsFormat de champ de réponse précisé `status`
- POST /api/v1/revisions/{revision_id}/exportsFormat de champ de réponse précisé `status`
- POST /api/v1/revisions/{revision_id}/exportsFormat de champ de réponse précisé `status`
- POST /api/v1/revisions/{revision_id}/exportsFormat de champ de réponse précisé `status`
- POST /api/v1/revisions/{revision_id}/exportsFormat de champ de réponse précisé `status`
- GET /api/v1/revisions/{revision_id}/ids-resultsNouvel en-tête de réponse documenté `ratelimit`
- GET /api/v1/revisions/{revision_id}/ids-resultsNouvel en-tête de réponse documenté `ratelimit-policy`
- GET /api/v1/revisions/{revision_id}/ids-resultsFormat d'en-tête de réponse précisé `retry-after`
- GET /api/v1/revisions/{revision_id}/ids-resultsFormat d'en-tête de réponse précisé `retry-after`
- GET /api/v1/revisions/{revision_id}/ids-resultsNouveau statut d'erreur documenté `500`
- GET /api/v1/revisions/{revision_id}/ids-resultsFormat de champ de réponse précisé `data/items/specification_count`
- GET /api/v1/revisions/{revision_id}/ids-resultsFormat de champ de réponse précisé `data/items/specification_count_applicable`
- GET /api/v1/revisions/{revision_id}/ids-resultsFormat de champ de réponse précisé `data/items/specification_count_failed`
- GET /api/v1/revisions/{revision_id}/ids-resultsFormat de champ de réponse précisé `data/items/specifications/items/entity_count_applicable`
- GET /api/v1/revisions/{revision_id}/ids-resultsFormat de champ de réponse précisé `data/items/specifications/items/entity_count_invalid`
- GET /api/v1/revisions/{revision_id}/ids-resultsFormat de champ de réponse précisé `data/items/specifications/items/entity_count_valid`
- GET /api/v1/revisions/{revision_id}/ids-resultsFormat de champ de réponse précisé `data/items/specifications/items/index`
- GET /api/v1/revisions/{revision_id}/ids-resultsFormat de champ de réponse précisé `status`
- GET /api/v1/revisions/{revision_id}/ids-resultsFormat de champ de réponse précisé `status`
- GET /api/v1/revisions/{revision_id}/ids-resultsFormat de champ de réponse précisé `status`
- GET /api/v1/revisions/{revision_id}/ids-resultsFormat de champ de réponse précisé `status`
- GET /api/v1/revisions/{revision_id}/ids-resultsFormat de champ de réponse précisé `status`
- POST /api/v1/uploadsNouvel en-tête de réponse documenté `ratelimit`
- POST /api/v1/uploadsNouvel en-tête de réponse documenté `ratelimit`
- POST /api/v1/uploadsNouvel en-tête de réponse documenté `ratelimit`
- POST /api/v1/uploadsNouvel en-tête de réponse documenté `ratelimit-policy`
- POST /api/v1/uploadsNouvel en-tête de réponse documenté `ratelimit-policy`
- POST /api/v1/uploadsNouvel en-tête de réponse documenté `ratelimit-policy`
- POST /api/v1/uploadsFormat d'en-tête de réponse précisé `retry-after`
- POST /api/v1/uploadsFormat d'en-tête de réponse précisé `retry-after`
- POST /api/v1/uploadsNouveau statut d'erreur documenté `500`
- POST /api/v1/uploadsFormat de champ de réponse précisé `size_bytes`
- POST /api/v1/uploadsFormat de champ de réponse précisé `status`
- POST /api/v1/uploadsFormat de champ de réponse précisé `status`
- POST /api/v1/uploadsFormat de champ de réponse précisé `status`
- POST /api/v1/uploadsFormat de champ de réponse précisé `status`
- POST /api/v1/uploadsFormat de champ de réponse précisé `status`
- POST /api/v1/uploadsFormat de champ de réponse précisé `status`
- POST /api/v1/uploadsFormat de champ de réponse précisé `status`
- POST /api/v1/uploads/{upload_id}/completeNouvel en-tête de réponse documenté `ratelimit`
- POST /api/v1/uploads/{upload_id}/completeNouvel en-tête de réponse documenté `ratelimit`
- POST /api/v1/uploads/{upload_id}/completeNouvel en-tête de réponse documenté `ratelimit`
- POST /api/v1/uploads/{upload_id}/completeNouvel en-tête de réponse documenté `ratelimit-policy`
- POST /api/v1/uploads/{upload_id}/completeNouvel en-tête de réponse documenté `ratelimit-policy`
- POST /api/v1/uploads/{upload_id}/completeNouvel en-tête de réponse documenté `ratelimit-policy`
- POST /api/v1/uploads/{upload_id}/completeFormat d'en-tête de réponse précisé `retry-after`
- POST /api/v1/uploads/{upload_id}/completeFormat d'en-tête de réponse précisé `retry-after`
- POST /api/v1/uploads/{upload_id}/completeNouveau statut d'erreur documenté `500`
- POST /api/v1/uploads/{upload_id}/completeFormat de champ de réponse précisé `size_bytes`
- POST /api/v1/uploads/{upload_id}/completeFormat de champ de réponse précisé `status`
- POST /api/v1/uploads/{upload_id}/completeFormat de champ de réponse précisé `status`
- POST /api/v1/uploads/{upload_id}/completeFormat de champ de réponse précisé `status`
- POST /api/v1/uploads/{upload_id}/completeFormat de champ de réponse précisé `status`
- POST /api/v1/uploads/{upload_id}/completeFormat de champ de réponse précisé `status`
- POST /api/v1/uploads/{upload_id}/completeFormat de champ de réponse précisé `status`
- POST /api/v1/uploads/{upload_id}/completeFormat de champ de réponse précisé `status`
- GET /api/v1/webhooksNouvel en-tête de réponse documenté `ratelimit`
- GET /api/v1/webhooksNouvel en-tête de réponse documenté `ratelimit-policy`
- GET /api/v1/webhooksFormat d'en-tête de réponse précisé `retry-after`
- GET /api/v1/webhooksFormat d'en-tête de réponse précisé `retry-after`
- GET /api/v1/webhooksNouveau statut d'erreur documenté `500`
- GET /api/v1/webhooksFormat de champ de réponse précisé `data/items/last_status`
- GET /api/v1/webhooksFormat de champ de réponse précisé `status`
- GET /api/v1/webhooksFormat de champ de réponse précisé `status`
- GET /api/v1/webhooksFormat de champ de réponse précisé `status`
- GET /api/v1/webhooksFormat de champ de réponse précisé `status`
- GET /api/v1/webhooksFormat de champ de réponse précisé `status`
- POST /api/v1/webhooksNouvel en-tête de réponse documenté `ratelimit`
- POST /api/v1/webhooksNouvel en-tête de réponse documenté `ratelimit`
- POST /api/v1/webhooksNouvel en-tête de réponse documenté `ratelimit-policy`
- POST /api/v1/webhooksNouvel en-tête de réponse documenté `ratelimit-policy`
- POST /api/v1/webhooksFormat d'en-tête de réponse précisé `retry-after`
- POST /api/v1/webhooksFormat d'en-tête de réponse précisé `retry-after`
- POST /api/v1/webhooksNouveau statut d'erreur documenté `500`
- POST /api/v1/webhooksFormat de champ de réponse précisé `allOf[#/components/schemas/Webhook]/last_status`
- POST /api/v1/webhooksFormat de champ de réponse précisé `status`
- POST /api/v1/webhooksFormat de champ de réponse précisé `status`
- POST /api/v1/webhooksFormat de champ de réponse précisé `status`
- POST /api/v1/webhooksFormat de champ de réponse précisé `status`
- POST /api/v1/webhooksFormat de champ de réponse précisé `status`
- POST /api/v1/webhooksFormat de champ de réponse précisé `status`
- DELETE /api/v1/webhooks/{webhook_id}Nouvel en-tête de réponse documenté `ratelimit`
- DELETE /api/v1/webhooks/{webhook_id}Nouvel en-tête de réponse documenté `ratelimit`
- DELETE /api/v1/webhooks/{webhook_id}Nouvel en-tête de réponse documenté `ratelimit-policy`
- DELETE /api/v1/webhooks/{webhook_id}Nouvel en-tête de réponse documenté `ratelimit-policy`
- DELETE /api/v1/webhooks/{webhook_id}Format d'en-tête de réponse précisé `retry-after`
- DELETE /api/v1/webhooks/{webhook_id}Format d'en-tête de réponse précisé `retry-after`
- DELETE /api/v1/webhooks/{webhook_id}Nouveau statut d'erreur documenté `500`
- DELETE /api/v1/webhooks/{webhook_id}Format de champ de réponse précisé `status`
- DELETE /api/v1/webhooks/{webhook_id}Format de champ de réponse précisé `status`
- DELETE /api/v1/webhooks/{webhook_id}Format de champ de réponse précisé `status`
- DELETE /api/v1/webhooks/{webhook_id}Format de champ de réponse précisé `status`
- DELETE /api/v1/webhooks/{webhook_id}Format de champ de réponse précisé `status`
- GET /api/v1/webhooks/{webhook_id}/deliveriesNouvel en-tête de réponse documenté `ratelimit`
- GET /api/v1/webhooks/{webhook_id}/deliveriesNouvel en-tête de réponse documenté `ratelimit`
- GET /api/v1/webhooks/{webhook_id}/deliveriesNouvel en-tête de réponse documenté `ratelimit-policy`
- GET /api/v1/webhooks/{webhook_id}/deliveriesNouvel en-tête de réponse documenté `ratelimit-policy`
- GET /api/v1/webhooks/{webhook_id}/deliveriesFormat d'en-tête de réponse précisé `retry-after`
- GET /api/v1/webhooks/{webhook_id}/deliveriesFormat d'en-tête de réponse précisé `retry-after`
- GET /api/v1/webhooks/{webhook_id}/deliveriesNouveau statut d'erreur documenté `500`
- GET /api/v1/webhooks/{webhook_id}/deliveriesFormat de champ de réponse précisé `data/items/attempts`
- GET /api/v1/webhooks/{webhook_id}/deliveriesFormat de champ de réponse précisé `data/items/response_code`
- GET /api/v1/webhooks/{webhook_id}/deliveriesFormat de champ de réponse précisé `status`
- GET /api/v1/webhooks/{webhook_id}/deliveriesFormat de champ de réponse précisé `status`
- GET /api/v1/webhooks/{webhook_id}/deliveriesFormat de champ de réponse précisé `status`
- GET /api/v1/webhooks/{webhook_id}/deliveriesFormat de champ de réponse précisé `status`
- GET /api/v1/webhooks/{webhook_id}/deliveriesFormat de champ de réponse précisé `status`
- GET /api/v1/webhooks/{webhook_id}/deliveriesFormat de champ de réponse précisé `status`
- POST /api/v1/webhooks/{webhook_id}/deliveries/{delivery_id}/retryNouvel en-tête de réponse documenté `ratelimit`
- POST /api/v1/webhooks/{webhook_id}/deliveries/{delivery_id}/retryNouvel en-tête de réponse documenté `ratelimit`
- POST /api/v1/webhooks/{webhook_id}/deliveries/{delivery_id}/retryNouvel en-tête de réponse documenté `ratelimit-policy`
- POST /api/v1/webhooks/{webhook_id}/deliveries/{delivery_id}/retryNouvel en-tête de réponse documenté `ratelimit-policy`
- POST /api/v1/webhooks/{webhook_id}/deliveries/{delivery_id}/retryFormat d'en-tête de réponse précisé `retry-after`
- POST /api/v1/webhooks/{webhook_id}/deliveries/{delivery_id}/retryFormat d'en-tête de réponse précisé `retry-after`
- POST /api/v1/webhooks/{webhook_id}/deliveries/{delivery_id}/retryNouveau statut d'erreur documenté `500`
- POST /api/v1/webhooks/{webhook_id}/deliveries/{delivery_id}/retryFormat de champ de réponse précisé `attempts`
- POST /api/v1/webhooks/{webhook_id}/deliveries/{delivery_id}/retryFormat de champ de réponse précisé `response_code`
- POST /api/v1/webhooks/{webhook_id}/deliveries/{delivery_id}/retryFormat de champ de réponse précisé `status`
- POST /api/v1/webhooks/{webhook_id}/deliveries/{delivery_id}/retryFormat de champ de réponse précisé `status`
- POST /api/v1/webhooks/{webhook_id}/deliveries/{delivery_id}/retryFormat de champ de réponse précisé `status`
- POST /api/v1/webhooks/{webhook_id}/deliveries/{delivery_id}/retryFormat de champ de réponse précisé `status`
- POST /api/v1/webhooks/{webhook_id}/deliveries/{delivery_id}/retryFormat de champ de réponse précisé `status`
- POST /api/v1/webhooks/{webhook_id}/deliveries/{delivery_id}/retryFormat de champ de réponse précisé `status`
2026-10-22 · v1.0.1
Adresse officielle de l'API : https://api.seve-up.app. L'adresse https://seveup-gateway.onrender.com répond toujours, mais ne fait plus partie du contrat.
2026-10-21 · v1.0.0
Première version publique : projets, maquettes, révisions, dépôts de fichiers (TUS), jeux d'exigences, contrôles IDS, jobs, exports et webhooks (Standard Webhooks).

API SeveUp

Serveurs

Démarrer

1.Créer une clé

2.Lister les projets

3.Ouvrir un dépôt

4.Envoyer le fichier

5.Créer la maquette

6.Suivre le traitement

7.Contrôler avec un IDS et lire le résultat

Erreurs

Projets

Paramètres

Réponses

Paramètres

Réponses

Maquettes

Paramètres

Réponses

Paramètres

Corps de la requêteModelCreate

Réponses

Paramètres

Réponses

Paramètres

Réponses

Paramètres

Corps de la requêteRevisionCreate

Réponses

Paramètres

Réponses

Fichiers

Paramètres

Corps de la requêteUploadCreate

Réponses

Paramètres

Corps de la requête

Réponses

IDS

Paramètres

Réponses

Paramètres

Réponses

Paramètres

Réponses

Paramètres

Corps de la requêteRequirementSetCreate

Réponses

Paramètres

Corps de la requêteIdsCheckCreate

Réponses

Exports

Paramètres

Corps de la requêteExportCreate

Réponses

Jobs

Paramètres

Réponses

Webhooks

Paramètres

Réponses

Paramètres

Corps de la requêteWebhookCreate

Réponses

Paramètres

Réponses

Paramètres

Réponses

Paramètres

Réponses

Événements webhook

revision.processing.completed

revision.processing.failed

ids_check.completed

ids_check.failed

export.ready

Schémas

Problem object

Page object

ProcessingStatus string