Obtenir un bearer court

Echange une cle API brute contre un bearer MARKO court. La signature HMAC-SHA256 est calculee avec la cle API brute sur le message canonique MARKO-EXTERNAL-API-TOKEN-V1\n{key_id}\n{timestamp}\n{nonce}. Utilisez ensuite Authorization: Bearer YOUR_BEARER_HERE sur les endpoints metier.

Cette route échange la signature HMAC contre un bearer; aucun bearer préalable n’est requis. Authentification.

cURL + OpenSSL

cURL

api_key="YOUR_API_KEY"
key_id="YOUR_PUBLIC_KEY_ID"
timestamp="$(date +%s)"
nonce="$(openssl rand -hex 16)"
message="$(printf 'MARKO-EXTERNAL-API-TOKEN-V1\n%s\n%s\n%s' "$key_id" "$timestamp" "$nonce")"
signature="$(printf "%s" "$message" | openssl dgst -sha256 -hmac "$api_key" -hex | awk '{print $2}')"

curl -X POST "https://partner-api.marko.fr/v1/auth/token" \
  -H "Content-Type: application/json" \
  -H "X-Request-ID: marko-auth-token" \
  --data "$(printf '{"key_id":"%s","timestamp":%s,"nonce":"%s","signature":"%s"}' "$key_id" "$timestamp" "$nonce" "$signature")"

200

{
  "access_token": "YOUR_BEARER_HERE",
  "token_type": "Bearer",
  "expires_in": 900,
  "issued_at": "2026-04-23T10:00:00Z",
  "expires_at": "2026-04-23T10:15:00Z",
  "key_id": "YOUR_PUBLIC_KEY_ID",
  "environment": "live",
  "entity_slug": "clubfunding"
}

Headers

X-Request-ID · string

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

Body

application/json

key_id · string · required

Identifiant public de la clé; utiliser la valeur réelle fournie par l'administrateur.

Required string length: 4 - 24

Pattern: ^[a-z0-9]+$

timestamp · integer · required

Heure Unix en secondes de l'échange signé.

Required range: x >= 0

nonce · string · required

Valeur aléatoire unique pour cet échange; ne jamais réutiliser un nonce avec la même clé.

Required string length: 16 - 128

Pattern: ^[A-Za-z0-9_-]+$

signature · string · required

HMAC-SHA256 hexadécimal du message canonique à quatre lignes; voir Authentification.

Required string length: 64

Pattern: ^[A-Fa-f0-9]{64}$

Response

200

application/json

Successful response

access_token · string · required

Bearer de courte durée à utiliser dans Authorization.

expires_in · integer · required

Durée du bearer en secondes; utilisez la valeur retournée plutôt qu'une durée fixe.

Required range: x >= 1

issued_at · string<date-time> · required

Date d'émission du bearer.

expires_at · string<date-time> · required

Date d'expiration du bearer.

key_id · string · required

Identifiant public de la clé; utiliser la valeur réelle fournie par l'administrateur.

environment · string · required

Environnement de données associé à la clé; distinct de l'hôte d'infrastructure.

entity_slug · string · required

Entité à laquelle l'intégration est rattachée.

token_type · string · default: Bearer

Type de jeton retourné: Bearer.