Obtenir la timeline d'audit (versions NF203) d'une réservation

GET

/v1/reservations/{id}/timeline

curl --request GET \
  --url https://example.com/v1/reservations/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/timeline \
  --header 'X-API-Key: <X-API-Key>'

Authorizations

• ApiKeyAuth
• BearerAuth

Parameters

Path Parameters

id

required

string format: uuid

Responses

200

Timeline des versions (ordre croissant de sequenceNumber)

Media type application/json

object

data

required

object

reservationId

required

string format: uuid

versions

required

Array<object>

object

sequenceNumber

required

integer

>= 1

occurredAt

required

string format: date-time

modifiedBy

required

Acteur BRUT de la modification (NF203) — identifiant journalisé, conservé pour compat.

string

modifiedByKind

required

Nature de l’acteur résolu (ADR-00D117 A1). unknown = fail-open d’affichage (lookup raté / donnée corrompue).

string

Allowed values: user system unknown

modifiedByLabel

required

Libellé d’affichage de l’acteur : email (user), code agent (system — ex. night_audit, booking_engine, ota:, platform), valeur brute (unknown).

string

action

required

Code canonique de l’acte (ADR-00D117 A2 — string documentée, PAS un enum de schéma : la liste peut s’étendre sans breaking). Codes V1 : create, confirm, cancel, check_in, check_out, close, no_show, walk, modify, reprice, adjust_stay_dates, attach_folio, pre_assign_unit, release_pre_assignment, consume_pre_assignment, individualise_occupant.

string

modificationReason

Motif pur (enum métier d’annulation, motif canonique de libération, ou texte libre). Vide si l’acte n’en porte pas.

string

statusBefore

required

string

statusAfter

required

string

changes

required

Array<object>

object

field

required

string

before

required

string

nullable

after

required

string

nullable

Example

{
  "data": {
    "versions": [
      {
        "modifiedByKind": "user"
      }
    ]
  }
}

401

Non authentifié

Media type application/json

object

code

required

Code machine de l’erreur

string

message

required

Message lisible

string

origin

Origine domaine de l’erreur (optionnel)

object

boundedContext

string

module

string

status

required

integer

traceId

required

Identifiant de corrélation pour le support

string

Example

{
  "code": "RESERVATION_NOT_FOUND",
  "message": "Réservation introuvable",
  "status": 404
}

403

Permission refusée ou scope IDOR

Media type application/json

object

code

required

Code machine de l’erreur

string

message

required

Message lisible

string

origin

Origine domaine de l’erreur (optionnel)

object

boundedContext

string

module

string

status

required

integer

traceId

required

Identifiant de corrélation pour le support

string

Example

{
  "code": "RESERVATION_NOT_FOUND",
  "message": "Réservation introuvable",
  "status": 404
}

404

Réservation introuvable

Media type application/json

object

code

required

Code machine de l’erreur

string

message

required

Message lisible

string

origin

Origine domaine de l’erreur (optionnel)

object

boundedContext

string

module

string

status

required

integer

traceId

required

Identifiant de corrélation pour le support

string

Example

{
  "code": "RESERVATION_NOT_FOUND",
  "message": "Réservation introuvable",
  "status": 404
}