Consulter l'ancre à une date

GET

/relation-tiers/v1/actors/{actorId}

curl --request GET \
  --url https://example.com/relation-tiers/v1/actors/example \
  --header 'Authorization: Bearer <token>'

Autorisations

• authentification
  relation-tiers:consultation

Paramètres

Paramètres (path)

actorId

required

string

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

Paramètres (query)

effectiveAt

string format: date-time

La date d’effet de la lecture — la situation applicable à cette date ; absente, la lecture porte sur maintenant.

Réponses

200

L’ancre applicable à la date demandée.

Media typeapplication/json

object

actorId

required

string

identityMode

required

string

Allowed values: REFERENCE_DOMAINE IDENTITE_LOCALE

actorNature

required

string

Allowed values: LEGAL_ENTITY NATURAL_PERSON COLLECTIVE TECHNICAL_PARTY

ownerReference

object

domain

required

string

objectType

required

string

objectId

required

string

displayLabel

string

status

required

string

aggregateVersion

required

integer

redirectedTo

L’ancre canonique si une redirection logique est active.

string

Example

{
  "identityMode": "REFERENCE_DOMAINE",
  "actorNature": "LEGAL_ENTITY"
}

401

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

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 ne produit jamais ce code sur une ressource — il produit 404 (ne rien révéler).

404

Ressource absente ou invisible — y compris une ressource d’un autre tenant : le régime de la muraille ne révèle pas l’existence (404, jamais 403).

Media typeapplication/json

L’enveloppe d’erreur du catalogue (Problem Details) — le texte n’expose ni l’existence d’un objet d’un autre tenant, ni une donnée sensible.

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

Example^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "code": "example",
  "detail": "example",
  "instance": "example",
  "correlationId": "example",
  "retryable": true,
  "violations": [
    {
      "field": "example",
      "reason": "example",
      "ruleId": "example"
    }
  ]
}