Exemples Python, Node.js et PHP

Des programmes sans dépendances pour signer l’échange HMAC et appeler les routes JSON.

Les trois programmes ci-dessous utilisent les bibliothèques standard de leur langage. Ils signent l’échange HMAC, conservent le bearer et le renouvellent avant son expiration. Ils lisent une page d’opérations lorsqu’ils sont exécutés directement.

Exécuter le premier appel

Définir MARKO_KEY_ID et MARKO_API_SECRET dans l’environnement du processus. Pour la préproduction, définir aussi MARKO_API_BASE_URL=https://partner-api-preprod.marko.fr/v1. La clé doit autoriser operations:read.

Python 3.10+

curl --fail --location \
  https://raw.githubusercontent.com/mathieuworoniecki/marko-developer-docs/main/examples/python/marko_client.py \
  --output marko_client.py
python3 marko_client.py

Lire le fichier téléchargé avant de l’exécuter. Le secret reste dans l’environnement côté serveur. Il est utilisé pour calculer la signature; il n’est pas envoyé sur les routes métier.

Utiliser le client JSON dans votre programme

Après avoir téléchargé le fichier correspondant, importer son client :

Python

from marko_client import ApiError, MarkoClient

api = MarkoClient()
try:
    result = api.request("GET", "/operations?limit=20&offset=0")
except ApiError as error:
    # Conserver status et request_id pour le diagnostic.
    # Ne pas journaliser de secret ou de bearer.
    print(error.status, error.request_id)
    raise

Les chemins sont relatifs au préfixe /v1. Encoder les valeurs de recherche et les segments variables avec la bibliothèque du langage.

Envoyer une écriture

La clé suivante représente une révision de la source. La conserver avec le contenu avant l’envoi. Cet exemple écrit dans l’entité de votre clé et exige operations:write.

Python

result = api.request(
    "PUT", "/operations/external/crm-operation-001",
    {"name": "Opération CRM de démonstration"},
    idempotency_key="crm-operation-001-revision-01",
)
marko_id = result["marko_id"]

Ce que ces exemples prennent en charge

Les réponses JSON et les réponses sans corps sont acceptées. Les erreurs exposent leur statut, le problème JSON disponible et l’identifiant de corrélation. Un 401 sur une lecture entraîne au plus un nouvel échange et une nouvelle lecture. Les écritures et les erreurs réseau ne sont pas répétées automatiquement.

Pour une reprise d’écriture, suivre Écritures et idempotence. Pour 429, respecter Retry-After lorsqu’il est fourni. Les exports binaires et les uploads multipart demandent un client adapté, comme cURL dans le tutoriel documentaire.

Ces programmes sont des exemples d’intégration, pas un SDK officiel couvrant toutes les routes. Ils sont testés avec une fixture HTTP locale pour les signatures, le renouvellement du bearer et le traitement des conflits. Cela ne prouve pas l’exécution des parcours métier avec votre clé ou vos données.