Créer une notification

curl --request POST \
  --url https://partner-api.marko.fr/v1/notifications \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "type": "custom",
  "severity": "info",
  "title": "Push partenaire",
  "target_url": "/dashboard"
}
'

import requests

url = "https://partner-api.marko.fr/v1/notifications"

payload = {
    "type": "custom",
    "severity": "info",
    "title": "Push partenaire",
    "target_url": "/dashboard"
}
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/notifications';
const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    type: 'custom',
    severity: 'info',
    title: 'Push partenaire',
    target_url: '/dashboard'
  })
};

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({
    type: 'custom',
    severity: 'info',
    title: 'Push partenaire',
    target_url: '/dashboard'
  })
};

fetch('https://partner-api.marko.fr/v1/notifications', 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/notifications",
  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([
    'type' => 'custom',
    'severity' => 'info',
    'title' => 'Push partenaire',
    'target_url' => '/dashboard'
  ]),
  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": "dddddddd-dddd-dddd-dddd-dddddddddddd",
  "type": "example",
  "severity": "example",
  "title": "Push partenaire",
  "target_url": "example",
  "read": false,
  "created_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: ^[!-~]+$

Body

application/json

type

string

required

Type de l'alerte ou de la notification.

title

string

required

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

target_url

string

required

Lien vers la ressource concernée dans l'interface MARKO.

severity

string

default:info

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

message

string | null

Message destiné à l'affichage ou au diagnostic.

target_tab

string | null

Onglet à ouvrir sur la cible dans MARKO.

target_filter

string | null

Filtre à appliquer lors de l'ouverture de la cible dans MARKO.

highlight_id

string | null

Identifiant de l'élément à mettre en évidence dans l'interface.

operation_id

string<uuid> | null

UUID MARKO de l'opération.

Response

Successful response

string<uuid>

required

Identifiant MARKO de la ressource.

type

string

required

Type de l'alerte ou de la notification.

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.

target_url

string

required

Lien vers la ressource concernée dans l'interface MARKO.

read

boolean

required

Indique si la notification ou l'alerte a été lue.

created_at

string<date-time>

required

Date de création au format ISO 8601.

user_id

string | null

Identifiant utilisateur MARKO; il n'est pas nécessairement un UUID.

message

string | null

Message destiné à l'affichage ou au diagnostic.

target_tab

string | null

Onglet à ouvrir sur la cible dans MARKO.

target_filter

string | null

Filtre à appliquer lors de l'ouverture de la cible dans MARKO.

highlight_id

string | null

Identifiant de l'élément à mettre en évidence dans l'interface.

operation_id

string<uuid> | null

UUID MARKO de l'opération.

is_composite

boolean

default:false

Indique si la notification regroupe plusieurs informations.

was_false_positive

boolean

default:false

Indique si cette notification a été déclarée comme faux positif.

alert_status

string | null

État de traitement de l'alerte, distinct de son niveau de gravité.

snoozed_until

string<date-time> | null

Date jusqu'à laquelle l'alerte ou la recommandation est reportée.

escalation_level

integer | null

Niveau d'escalade de l'alerte ou de la notification.

⌘I

Créer une notification

curl --request POST \
  --url https://partner-api.marko.fr/v1/notifications \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "type": "custom",
  "severity": "info",
  "title": "Push partenaire",
  "target_url": "/dashboard"
}
'

import requests

url = "https://partner-api.marko.fr/v1/notifications"

payload = {
    "type": "custom",
    "severity": "info",
    "title": "Push partenaire",
    "target_url": "/dashboard"
}
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/notifications';
const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    type: 'custom',
    severity: 'info',
    title: 'Push partenaire',
    target_url: '/dashboard'
  })
};

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({
    type: 'custom',
    severity: 'info',
    title: 'Push partenaire',
    target_url: '/dashboard'
  })
};

fetch('https://partner-api.marko.fr/v1/notifications', 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/notifications",
  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([
    'type' => 'custom',
    'severity' => 'info',
    'title' => 'Push partenaire',
    'target_url' => '/dashboard'
  ]),
  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": "dddddddd-dddd-dddd-dddd-dddddddddddd",
  "type": "example",
  "severity": "example",
  "title": "Push partenaire",
  "target_url": "example",
  "read": false,
  "created_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 une notification

Authorizations

Headers

Body

Response