Mettre à jour les paramètres de l'entité

curl --request PUT \
  --url https://partner-api.marko.fr/v1/settings \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "risk_threshold": 80,
  "zone_vacances": "A"
}
'

import requests

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

payload = {
    "risk_threshold": 80,
    "zone_vacances": "A"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const url = 'https://partner-api.marko.fr/v1/settings';
const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({risk_threshold: 80, zone_vacances: 'A'})
};

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

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({risk_threshold: 80, zone_vacances: 'A'})
};

fetch('https://partner-api.marko.fr/v1/settings', 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/settings",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'risk_threshold' => 80,
    'zone_vacances' => 'A'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

{
  "id": "example",
  "name": "Exemple MARKO",
  "type": "example",
  "mode_reporting": "example",
  "frequence_reporting": 0,
  "risk_threshold": 80,
  "zone_vacances": "A",
  "portfolio_goals": {}
}

{
  "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"
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "type": "about:blank",
  "request_id": "<string>",
  "scope": "<string>",
  "route_id": "<string>",
  "reason_code": "<string>"
}

{
  "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": "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"
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "type": "about:blank",
  "request_id": "<string>",
  "scope": "<string>",
  "route_id": "<string>",
  "reason_code": "<string>"
}

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.

Body

application/json

Update entity settings (reporting mode, frequency, goals, etc.).

mode_reporting

enum<string> | null

Mode de reporting configuré pour l'entité.

Available options:

calendaire,

post_anniversaire

frequence_reporting

integer | null

Fréquence de reporting configurée pour l'entité.

Required range: 1 <= x <= 12

portfolio_goals

Portfolio Goals · object | null

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

report_external_neutrality

boolean | null

Paramètre de neutralité du reporting externe de l'entité.

siren

string | null

SIREN français sur 9 chiffres; le service vérifie aussi le checksum lorsque la route le prévoit.

date_reference_reporting

string<date> | null

Date de référence utilisée par le reporting de l'entité.

risk_threshold

integer | null

Seuil de risque configuré pour l'entité.

Required range: 0 <= x <= 100

zone_vacances

enum<string> | null

Zone de vacances configurée pour la planification de l'entité.

Available options:

A,

B,

C

logo_url

string | null

URL du logo de l'entité.

primary_color

string | null

Couleur principale de la marque de l'entité.

secondary_color

string | null

Couleur secondaire de la marque de l'entité.

brand_baseline

string | null

Texte de signature associé à la marque de l'entité.

Maximum string length: 255

email_brand_name

string | null

Nom de marque utilisé dans les e-mails de l'entité.

Maximum string length: 255

email_from_address

string<email> | null

Adresse d'expédition configurée pour les e-mails.

Maximum string length: 255

email_reply_to

string<email> | null

Adresse proposée pour répondre aux e-mails.

Maximum string length: 255

email_branding_mode

enum<string> | null

Mode de personnalisation des e-mails.

Available options:

marko,

co_branded,

white_label

Response

Successful response

Entity settings response.

string

required

Identifiant MARKO de la ressource.

name

string

required

Nom de la ressource. Les recherches exactes et partielles sont décrites au niveau de la route.

type

string

required

Type de l'entité MARKO.

mode_reporting

string

required

Mode de reporting configuré pour l'entité.

frequence_reporting

integer

required

Fréquence de reporting configurée pour l'entité.

portfolio_goals

Portfolio Goals · object

required

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

siren

string | null

SIREN français sur 9 chiffres; le service vérifie aussi le checksum lorsque la route le prévoit.

date_reference_reporting

string<date> | null

Date de référence utilisée par le reporting de l'entité.

risk_threshold

integer

default:60

Seuil de risque configuré pour l'entité.

zone_vacances

string

default:C

Zone de vacances configurée pour la planification de l'entité.

report_external_neutrality

boolean

default:true

Paramètre de neutralité du reporting externe de l'entité.

logo_url

string | null

URL du logo de l'entité.

primary_color

string | null

Couleur principale de la marque de l'entité.

secondary_color

string | null

Couleur secondaire de la marque de l'entité.

brand_baseline

string | null

Texte de signature associé à la marque de l'entité.

email_brand_name

string | null

Nom de marque utilisé dans les e-mails de l'entité.

email_from_address

string<email> | null

Adresse d'expédition configurée pour les e-mails.

email_reply_to

string<email> | null

Adresse proposée pour répondre aux e-mails.

email_branding_mode

enum<string>

default:marko

Mode de personnalisation des e-mails.

Available options:

marko,

co_branded,

white_label

email_branding_version

integer

default:1

Version de la configuration de marque des e-mails.

email_sending_domain_status

string

default:not_configured

État de validation du domaine d'expédition.

email_sending_domain

string | null

Domaine d'expédition configuré pour l'entité.

ai_enabled

boolean

default:true

Indique si les fonctions IA sont activées pour l'entité; les droits de la clé restent requis.

manual_creation_policy

ManualCreationPolicy · object

Politique de création manuelle par famille de ressources.

Show child attributes

⌘I

Mettre à jour les paramètres de l'entité

curl --request PUT \
  --url https://partner-api.marko.fr/v1/settings \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "risk_threshold": 80,
  "zone_vacances": "A"
}
'

import requests

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

payload = {
    "risk_threshold": 80,
    "zone_vacances": "A"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const url = 'https://partner-api.marko.fr/v1/settings';
const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({risk_threshold: 80, zone_vacances: 'A'})
};

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

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({risk_threshold: 80, zone_vacances: 'A'})
};

fetch('https://partner-api.marko.fr/v1/settings', 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/settings",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'risk_threshold' => 80,
    'zone_vacances' => 'A'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

{
  "id": "example",
  "name": "Exemple MARKO",
  "type": "example",
  "mode_reporting": "example",
  "frequence_reporting": 0,
  "risk_threshold": 80,
  "zone_vacances": "A",
  "portfolio_goals": {}
}

{
  "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"
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "type": "about:blank",
  "request_id": "<string>",
  "scope": "<string>",
  "route_id": "<string>",
  "reason_code": "<string>"
}

{
  "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": "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"
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "type": "about:blank",
  "request_id": "<string>",
  "scope": "<string>",
  "route_id": "<string>",
  "reason_code": "<string>"
}

Démarrer

Tutoriels

Intégrer

Référence API

Mettre à jour les paramètres de l'entité

Authorizations

Headers

Body

Response