Créer un événement de risque tiers

curl --request POST \
  --url https://partner-api.marko.fr/v1/operateurs/{operateur_id}/third-party-risks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "operateur_id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
  "source": "manual",
  "event_type": "watchlist",
  "severity": "warning",
  "title": "Alerte manuelle"
}
'

import requests

url = "https://partner-api.marko.fr/v1/operateurs/{operateur_id}/third-party-risks"

payload = {
    "operateur_id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
    "source": "manual",
    "event_type": "watchlist",
    "severity": "warning",
    "title": "Alerte manuelle"
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const url = 'https://partner-api.marko.fr/v1/operateurs/{operateur_id}/third-party-risks';
const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    operateur_id: 'aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa',
    source: 'manual',
    event_type: 'watchlist',
    severity: 'warning',
    title: 'Alerte manuelle'
  })
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    operateur_id: 'aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa',
    source: 'manual',
    event_type: 'watchlist',
    severity: 'warning',
    title: 'Alerte manuelle'
  })
};

fetch('https://partner-api.marko.fr/v1/operateurs/{operateur_id}/third-party-risks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://partner-api.marko.fr/v1/operateurs/{operateur_id}/third-party-risks",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'operateur_id' => 'aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa',
    'source' => 'manual',
    'event_type' => 'watchlist',
    'severity' => 'warning',
    'title' => 'Alerte manuelle'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "Idempotency-Key: <idempotency-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "id": "11111111-1111-4111-8111-111111111111",
  "operateur_id": "11111111-1111-4111-8111-111111111111",
  "source": "example",
  "event_type": "example",
  "severity": "warning",
  "title": "Alerte manuelle",
  "detected_at": "2026-10-01T10:00:00Z",
  "created_at": "2026-10-01T10:00:00Z",
  "updated_at": "2026-10-01T10:00:00Z"
}

{
  "type": "about:blank",
  "title": "Bad Request",
  "status": 400,
  "detail": "Idempotency-Key must contain at most 255 visible ASCII characters without spaces.",
  "request_id": "req_example_partner_call"
}

{
  "type": "about:blank",
  "title": "Unauthorized",
  "status": 401,
  "detail": "A valid bearer token is required.",
  "request_id": "req_example_partner_call"
}

{
  "type": "about:blank",
  "title": "Forbidden",
  "status": 403,
  "detail": "The API key does not allow this operation.",
  "request_id": "req_example_partner_call"
}

{
  "type": "about:blank",
  "title": "Conflict",
  "status": 409,
  "detail": "The idempotency key payload, external reference, target, or source conflicts with an existing write.",
  "request_id": "req_example_partner_call"
}

{
  "type": "about:blank",
  "title": "Unprocessable Content",
  "status": 422,
  "detail": "The request payload or parameters are invalid.",
  "request_id": "req_example_partner_call"
}

{
  "type": "about:blank",
  "title": "Precondition Required",
  "status": 428,
  "detail": "The Idempotency-Key header is required.",
  "request_id": "req_example_partner_call"
}

{
  "type": "about:blank",
  "title": "Too Many Requests",
  "status": 429,
  "detail": "The request rate limit was exceeded.",
  "request_id": "req_example_partner_call"
}

{
  "type": "about:blank",
  "title": "Internal Server Error",
  "status": 500,
  "detail": "An unexpected server error occurred.",
  "request_id": "req_example_partner_call"
}

Authorizations

Authorization

string

header

required

Use the access_token returned by POST /v1/auth/token. Do not send the raw API secret on business endpoints.

Headers

X-Request-ID

string

Partner-generated correlation identifier echoed in logs and error payloads.

Idempotency-Key

string

required

Required for every write, including environments where replay deduplication is disabled. Reuse the same value when retrying the same logical write and use a new value for a different write.

Maximum string length: 255

Pattern: ^[!-~]+$

Path Parameters

operateur_id

string<uuid>

required

UUID MARKO de l'opérateur.

Body

application/json

Create a third-party risk event manually.

operateur_id

string<uuid>

required

UUID MARKO de l'opérateur.

event_type

string

required

Event type: procedure_collective, privilege, nantissement, etc.

Maximum string length: 100

title

string

required

Titre affiché pour l'événement ou le problème.

Maximum string length: 500

source

enum<string>

default:manual

Origine de l'événement de risque concernant l'opérateur.

Available options:

pappers,

bodacc,

infogreffe,

manual

severity

enum<string>

default:info

Niveau de gravité de l'événement, distinct de son statut de traitement.

Available options:

info,

warning,

critical

description

string | null

Description libre de la ressource.

raw_data

Raw Data · object | null

Objet JSON extensible. Les types des valeurs sont indiqués par additionalProperties lorsque la route les contraint.

detected_at

string<date-time> | null

Date de détection de l'événement de risque.

risk_score_impact

number | null

Contribution de l'événement au score de risque.

Required range: -100 <= x <= 100

Response

Successful response

Response schema for a single third-party risk event.

string<uuid>

required

Identifiant MARKO de la ressource.

operateur_id

string<uuid>

required

UUID MARKO de l'opérateur.

source

string

required

Origine de l'événement de risque concernant l'opérateur.

event_type

string

required

Type de l'événement.

severity

string

required

Niveau de gravité de l'événement, distinct de son statut de traitement.

title

string

required

Titre affiché pour l'événement ou le problème.

detected_at

string<date-time>

required

Date de détection de l'événement de risque.

created_at

string<date-time>

required

Date de création au format ISO 8601.

updated_at

string<date-time>

required

Date de dernière modification au format ISO 8601.

provider_event_id

string | null

Identifiant de l'événement dans le système du fournisseur.

description

string | null

Description libre de la ressource.

raw_data

Raw Data · object | null

Objet JSON extensible. Les types des valeurs sont indiqués par additionalProperties lorsque la route les contraint.

resolved_at

string<date-time> | null

Date de résolution de l'événement, du commentaire ou du conflit.

risk_score_impact

number | null

Contribution de l'événement au score de risque.

is_resolved

boolean

default:false

Indique si le commentaire ou l'événement de risque est résolu.

⌘I

Créer un événement de risque tiers

curl --request POST \
  --url https://partner-api.marko.fr/v1/operateurs/{operateur_id}/third-party-risks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "operateur_id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
  "source": "manual",
  "event_type": "watchlist",
  "severity": "warning",
  "title": "Alerte manuelle"
}
'

import requests

url = "https://partner-api.marko.fr/v1/operateurs/{operateur_id}/third-party-risks"

payload = {
    "operateur_id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
    "source": "manual",
    "event_type": "watchlist",
    "severity": "warning",
    "title": "Alerte manuelle"
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const url = 'https://partner-api.marko.fr/v1/operateurs/{operateur_id}/third-party-risks';
const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    operateur_id: 'aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa',
    source: 'manual',
    event_type: 'watchlist',
    severity: 'warning',
    title: 'Alerte manuelle'
  })
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    operateur_id: 'aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa',
    source: 'manual',
    event_type: 'watchlist',
    severity: 'warning',
    title: 'Alerte manuelle'
  })
};

fetch('https://partner-api.marko.fr/v1/operateurs/{operateur_id}/third-party-risks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://partner-api.marko.fr/v1/operateurs/{operateur_id}/third-party-risks",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'operateur_id' => 'aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa',
    'source' => 'manual',
    'event_type' => 'watchlist',
    'severity' => 'warning',
    'title' => 'Alerte manuelle'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "Idempotency-Key: <idempotency-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "id": "11111111-1111-4111-8111-111111111111",
  "operateur_id": "11111111-1111-4111-8111-111111111111",
  "source": "example",
  "event_type": "example",
  "severity": "warning",
  "title": "Alerte manuelle",
  "detected_at": "2026-10-01T10:00:00Z",
  "created_at": "2026-10-01T10:00:00Z",
  "updated_at": "2026-10-01T10:00:00Z"
}

{
  "type": "about:blank",
  "title": "Bad Request",
  "status": 400,
  "detail": "Idempotency-Key must contain at most 255 visible ASCII characters without spaces.",
  "request_id": "req_example_partner_call"
}

{
  "type": "about:blank",
  "title": "Unauthorized",
  "status": 401,
  "detail": "A valid bearer token is required.",
  "request_id": "req_example_partner_call"
}

{
  "type": "about:blank",
  "title": "Forbidden",
  "status": 403,
  "detail": "The API key does not allow this operation.",
  "request_id": "req_example_partner_call"
}

{
  "type": "about:blank",
  "title": "Conflict",
  "status": 409,
  "detail": "The idempotency key payload, external reference, target, or source conflicts with an existing write.",
  "request_id": "req_example_partner_call"
}

{
  "type": "about:blank",
  "title": "Unprocessable Content",
  "status": 422,
  "detail": "The request payload or parameters are invalid.",
  "request_id": "req_example_partner_call"
}

{
  "type": "about:blank",
  "title": "Precondition Required",
  "status": 428,
  "detail": "The Idempotency-Key header is required.",
  "request_id": "req_example_partner_call"
}

{
  "type": "about:blank",
  "title": "Too Many Requests",
  "status": 429,
  "detail": "The request rate limit was exceeded.",
  "request_id": "req_example_partner_call"
}

{
  "type": "about:blank",
  "title": "Internal Server Error",
  "status": 500,
  "detail": "An unexpected server error occurred.",
  "request_id": "req_example_partner_call"
}

Démarrer

Tutoriels

Intégrer

Référence API

Créer un événement de risque tiers

Authorizations

Headers

Path Parameters

Body

Response