Suivre un job d'import

curl --request GET \
  --url https://partner-api.marko.fr/v1/import-jobs/{job_id} \
  --header 'Authorization: Bearer <token>'

const url = 'https://partner-api.marko.fr/v1/import-jobs/{job_id}';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

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

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://partner-api.marko.fr/v1/import-jobs/{job_id}', 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/import-jobs/{job_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

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

curl_close($curl);

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

{
  "job_id": "88888888-8888-8888-8888-888888888888",
  "status": "partial",
  "total_operations": 500,
  "total_notes": 5000,
  "processed_items": 5500,
  "completed_items": 5497,
  "noop_items": 1,
  "failed_items": 1,
  "conflict_items": 1,
  "cancel_requested": false,
  "accepted_at": "2026-07-16T08:00:00Z",
  "started_at": "2026-07-16T08:00:01Z",
  "completed_at": "2026-07-16T08:04:20Z",
  "created_at": "2026-07-16T08:00:00Z",
  "updated_at": "2026-07-16T08:04:20Z",
  "results_url": "/v1/import-jobs/88888888-8888-8888-8888-888888888888/items",
  "operation_id": null,
  "error_code": null,
  "error_message": null
}

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

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.

Path Parameters

job_id

string<uuid>

required

UUID du job durable à suivre.

Response

Successful response

job_id

string<uuid>

required

UUID du job durable à suivre.

status

string

required

État du job d'import: accepted, queued, running, partial, completed, failed ou cancelled. Lire les compteurs et les résultats individuels avant de considérer l'ensemble du lot comme réussi.

total_operations

integer

required

Nombre d'opérations du lot ou de la synthèse portefeuille.

total_notes

integer

required

Nombre de notes reçues dans le lot d'import.

processed_items

integer

required

Nombre d'éléments du lot qui ont reçu un résultat de traitement.

completed_items

integer

required

Nombre d'éléments d'import traités avec une mutation réussie.

noop_items

integer

required

Nombre d'éléments traités sans changement de la ressource.

failed_items

integer

required

Nombre d'éléments d'import en échec.

conflict_items

integer

required

Nombre d'éléments d'import arrêtés par un conflit à résoudre.

cancel_requested

boolean

required

Indique qu'une annulation du job a été demandée; les éléments déjà terminés sont conservés.

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.

results_url

string

required

Chemin permettant de lire les résultats individuels du job; peut être relatif à l'hôte de l'API.

accepted_at

string<date-time> | null

Date d'acceptation de la demande ou de la recommandation.

started_at

string<date-time> | null

Date de début du traitement.

completed_at

string<date-time> | null

Date de fin, lorsqu'une exécution ou un traitement est terminé.

operation_id

string<uuid> | null

UUID MARKO de l'opération.

error_code

string | null

Code exploitable pour diagnostiquer un échec; consulter aussi error_message.

error_message

string | null

Détail de l'échec, lorsqu'il est disponible.

⌘I

Suivre un job d'import

curl --request GET \
  --url https://partner-api.marko.fr/v1/import-jobs/{job_id} \
  --header 'Authorization: Bearer <token>'

const url = 'https://partner-api.marko.fr/v1/import-jobs/{job_id}';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

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

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://partner-api.marko.fr/v1/import-jobs/{job_id}', 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/import-jobs/{job_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

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

curl_close($curl);

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

{
  "job_id": "88888888-8888-8888-8888-888888888888",
  "status": "partial",
  "total_operations": 500,
  "total_notes": 5000,
  "processed_items": 5500,
  "completed_items": 5497,
  "noop_items": 1,
  "failed_items": 1,
  "conflict_items": 1,
  "cancel_requested": false,
  "accepted_at": "2026-07-16T08:00:00Z",
  "started_at": "2026-07-16T08:00:01Z",
  "completed_at": "2026-07-16T08:04:20Z",
  "created_at": "2026-07-16T08:00:00Z",
  "updated_at": "2026-07-16T08:04:20Z",
  "results_url": "/v1/import-jobs/88888888-8888-8888-8888-888888888888/items",
  "operation_id": null,
  "error_code": null,
  "error_message": null
}

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

Démarrer

Tutoriels

Intégrer

Référence API

Suivre un job d'import

Authorizations

Headers

Path Parameters

Response