Aller au contenu
Documentation de la Plateforme

Créer une demande

POST
/relation-tiers/v1/requests
curl --request POST \
  --url https://example.com/relation-tiers/v1/requests \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: example' \
  --data '{ "sourceInteractionId": "example", "sentAt": "2026-04-15T12:00:00Z", "receivedAt": "2026-04-15T12:00:00Z", "originChannel": "example", "requester": { "emitterActorId": "example", "representedActorId": "example", "beneficiaryActorId": "example", "identificationStatus": "NON_IDENTIFIE" }, "initialCategoryCode": "example", "sensitivityClassification": "example", "descriptionRef": "example" }'

Autorisations

Section intitulée « Autorisations »

Paramètres

Section intitulée « Paramètres »

Paramètres (header)

Section intitulée « Paramètres (header) »
X-Tenant-Id
string

Facultatif — le tenant fait foi dans le jeton ; s’il est fourni, il doit être identique, et le corps ne peut jamais le choisir.

X-Correlation-Id
string
Idempotency-Key
required
string

La clé d’idempotence de la commande — liée à l’intention métier, pas à la tentative réseau.

Corps de la requêterequired

Section intitulée « Corps de la requêterequired »
Media typeapplication/json
object
sourceInteractionId
string
sentAt
string format: date-time
receivedAt
required
string format: date-time
originChannel
required
string
requester
object
emitterActorId
string
representedActorId
string
beneficiaryActorId
string
identificationStatus
string
Allowed values: NON_IDENTIFIE DECLARE RAPPROCHE VERIFIE CONTESTE
initialCategoryCode
string
sensitivityClassification
string
descriptionRef

Référence documentaire du contenu — le contenu libre ne traverse pas ce contrat.

string

Réponses

Section intitulée « Réponses »

201

Section intitulée « 201 »

La demande est durablement reçue.

Media typeapplication/json
object
requestId
required
string
readableReference
string
status
required
string
originChannel
required
string
sentAt
string format: date-time
receivedAt
required
string format: date-time
requester
object
emitterActorId
string
representedActorId
string
beneficiaryActorId
string
identificationStatus
string
Allowed values: NON_IDENTIFIE DECLARE RAPPROCHE VERIFIE CONTESTE
categoryCode
string
taxonomyVersion
string
priority
string
queueId
string
escalationLevel
integer
aggregateVersion
required
integer
Example
{
  "requester": {
    "identificationStatus": "NON_IDENTIFIE"
  }
}

401

Section intitulée « 401 »

Aucune identité présentée (401).

403

Section intitulée « 403 »

L’identité présentée n’a pas la famille d’accès requise (403). Les 403 croisés entre familles sont prouvés par les tests d’assemblage. Un écart de tenant sur une ressource produit 404 (ne rien révéler), jamais ce code.

409

Section intitulée « 409 »

Version obsolète, chevauchement interdit ou clé d’idempotence réutilisée avec un contenu différent.

Media typeapplication/json

L’enveloppe d’erreur du catalogue (Problem Details).

object
type
required
string
title
required
string
status
required
integer
code
required
string
detail
string
instance
string
correlationId
required
string
retryable
boolean
violations
Array<object>
object
field
string
reason
string
ruleId
string
Examplegenerated
{
  "type": "example",
  "title": "example",
  "status": 1,
  "code": "example",
  "detail": "example",
  "instance": "example",
  "correlationId": "example",
  "retryable": true,
  "violations": [
    {
      "field": "example",
      "reason": "example",
      "ruleId": "example"
    }
  ]
}

422

Section intitulée « 422 »

Donnée comprise mais non admissible — règle identifiée, référence externe non résolue ou preuve insuffisante.

Media typeapplication/json

L’enveloppe d’erreur du catalogue (Problem Details).

object
type
required
string
title
required
string
status
required
integer
code
required
string
detail
string
instance
string
correlationId
required
string
retryable
boolean
violations
Array<object>
object
field
string
reason
string
ruleId
string
Examplegenerated
{
  "type": "example",
  "title": "example",
  "status": 1,
  "code": "example",
  "detail": "example",
  "instance": "example",
  "correlationId": "example",
  "retryable": true,
  "violations": [
    {
      "field": "example",
      "reason": "example",
      "ruleId": "example"
    }
  ]
}