Schémas

Problem object

• 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

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.

• space_namestring | null

  Nom de l'espace ; distingue deux projets de même nom rangés dans des espaces différents.

• space_pathstring | null

  Chemin de l'espace dans l'arborescence de l'organisation, par exemple ~/SNCF.

• 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, et nul quand il est inconnu (jamais 0 par défaut).

• created_atstring (date-time)requis

RevisionCreate object

• upload_idstring (uuid)requis

• milestonestring

IdsSpecificationResult object

• indexintegerrequis

• namestringrequis

• descriptionstring | null

  Description de la spécification dans le fichier IDS, quand l'IDS en a une.

• 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.

IdsFacet object

• typestringrequis

  Valeurs : ENTITY · ATTRIBUTE · PROPERTY · CLASSIFICATION · MATERIAL · PART_OF

• cardinalitystring

  Exigences seulement.

  Valeurs : required · optional · prohibited

• entitystring

  Classe IFC (ENTITY, PART_OF) ; une liste est rendue « one of A | B ».

• predefined_typestring

• property_setstring

• namestring

  Nom de l'attribut ou de la propriété.

• valuestring

  Valeur attendue : simple, ou la restriction décrite (« pattern L[0-9]{3} », « >= 0 »).

• data_typestring

• systemstring

  Système de classification.

• relationstring

• instructionsstring

IdsObjectCheck object

• requirementintegerrequis

  Position dans requirements.

• statestringrequis

  MISSING absente de l'objet et de son type, EMPTY présente sans valeur, PRESENT renseignée (voir value), NOT_CHECKED facette que les tables ne permettent pas de lire (classification, matériau, motif de nom…).

  Valeurs : MISSING · EMPTY · PRESENT · NOT_CHECKED

• valuestring | null

• value_matchesboolean | null

  La valeur respecte la contrainte de la facette ; nul si la facette n'en pose pas ou si la réponse n'est pas sûre.

• sourcestring | null

  Valeurs : object · type · null

IdsInvalidObject object

• object_idintegerrequis

  Identifiant de l'objet dans le fichier IFC (#123).

• global_idstring | null

• namestring | null

• ifc_classstring | null

• checksIdsObjectCheck[]requis

IdsSpecificationFailure object

• indexintegerrequis

• namestringrequis

• descriptionstring | null

• instructionsstring | null

• identifierstring | null

• statusstringrequis

  Valeurs : PASS · PARTIAL · FAIL · NA · MISMATCH

• applicablebooleanrequis

• cardinalitystring | null

  required : la maquette doit contenir de tels objets ; prohibited : elle ne doit pas en contenir.

  Valeurs : required · optional · prohibited · null

• failurestringrequis

  MISSING_OBJECTS aucun objet visé alors que l'IDS en exige, PROHIBITED_OBJECTS des objets interdits sont présents, APPLICABILITY_MISMATCH la classe existe mais aucun objet ne répond à l'applicabilité, INVALID_OBJECTS des objets visés ne respectent pas les exigences, NONE la spécification passe, NOT_APPLICABLE sans objet.

  Valeurs : MISSING_OBJECTS · PROHIBITED_OBJECTS · APPLICABILITY_MISMATCH · INVALID_OBJECTS · NONE · NOT_APPLICABLE

• score_percentnumber | null

• entity_count_applicableinteger

• entity_count_invalidinteger

• applicabilityIdsFacet[]requis

• requirementsIdsFacet[]requis

• invalid_objectsIdsInvalidObject[]requis

• invalid_objects_totalinteger | null

  Objets en échec listés par le contrôle ; nul si la liste n'est pas disponible.

IdsFailures object

• revision_idstring (uuid)requis

• requirement_set_idstring (uuid)requis

• requirement_set_revision_idstring (uuid)requis

• statusProcessingStatusrequis

• completed_atstring (date-time) | null

• definitions_availableboolean

• details_availableboolean

• object_data_availableboolean

• dataIdsSpecificationFailure[]requis

• next_cursorstring | null

• has_morebooleanrequis

IdsFailuresBcf object

• revision_idstring (uuid)requis

• requirement_set_idstring (uuid)requis

• requirement_set_revision_idstring (uuid)requis

• statusProcessingStatusrequis

• completed_atstring (date-time) | null

• details_availablebooleanrequis

• topic_countintegerrequis

• file_namestring | null

• size_bytesinteger | null

• download_urlstring (uri) | null

• download_expires_atstring (date-time) | null

ObjectRow object

• object_idintegerrequis

• global_idstring | null

• namestring | null

• ifc_classstring | null

• statestring | null

  Nul sans propriété ni attribut demandés.

  Valeurs : MISSING · EMPTY · PRESENT · null

• valuestring | null

• value_sourcestring | null

  Valeurs : object · type · null

ObjectPage object

• revision_idstring (uuid)requis

• dataObjectRow[]requis

• next_cursorstring | nullrequis

• has_morebooleanrequis

• totalinteger | null

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

  Nul quand le moteur n'a pas encore donné de progression.

• eta_secondsnumber | null

• targetobjectrequis

• resultobject | null

  Export : URL signée et taille. Contrôle IDS terminé : le score en une ligne (le détail se lit dans les résultats IDS de la révision). Conversion : nul, lire la révision.

• 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