Documentation B2B

API B2B – récupérer automatiquement les informations de commande et de produit

Notre API REST est à la disposition de chaque client disposant d'un compte client et permet de récupérer automatiquement les informations de commande et de produit et de les intégrer dans vos propres systèmes.

vpn_key Ouvrir l'accès API dans le compte Page clients professionnels

Authentification

Toutes les requêtes API nécessitent une API-Key valide, envoyée dans l'en-tête HTTP. L'accès API est lié à votre compte client et est généralement à la disposition des comptes clients.

info Vous n'avez pas besoin d'une demande B2B distincte : connectez-vous avec votre compte client, ouvrez l'onglet API et générez-y votre API-Key. Vers l'accès API →

Format de l'en-tête

HTTP Request Header

X-API-Key: YOUR_API_KEY_HERE
Content-Type: application/json
Accept: application/json

Exemple avec cURL

cURL

curl -X GET "https://artumos.com/api/v1/orders" \
  -H "X-API-Key: YOUR_API_KEY_HERE" \
  -H "Accept: application/json"

Base URL

Tous les endpoints sont relatifs à la Base URL suivante :

Base URL

https://artumos.com/api/v1

Toutes les réponses sont renvoyées au format JSON (Content-Type: application/json).

Rate Limits

Plan	Requêtes / minute	Requêtes / jour
Compte client	60	5.000
Limite étendue	sur demande	sur demande

En cas de dépassement, HTTP 429 Too Many Requests est renvoyé. L'en-tête Retry-After contient le temps d'attente en secondes.

Codes d'erreur

HTTP-Code	Signification
`200 OK`	Requête réussie
`400 Bad Request`	Paramètres invalides
`401 Unauthorized`	API-Key manquante ou invalide
`403 Forbidden`	Aucune autorisation pour cette ressource
`404 Not Found`	Ressource non trouvée
`429 Too Many Requests`	Limite de débit dépassée
`500 Internal Server Error`	Erreur serveur – veuillez contacter le support

Format de réponse d'erreur

JSON

{
  "success": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid or missing API key."
  }
}

Endpoint : commandes

GET /api/v1/orders Toutes les commandes du compte

Parameter	Type	Description
`page`	integer	Page (par défaut : 1)
`per_page`	integer	Entrées par page (max. 100)
`status`	string	`paid` \| `pending` \| `all`

Beispiel-Response

{
  "success": true,
  "data": {
    "orders": [
      {
        "id": "ORD-12345",
        "status": "paid",
        "total": 49.99,
        "currency": "EUR",
        "created_at": "2026-01-15T10:30:00Z",
        "items_count": 2
      }
    ],
    "pagination": {
      "page": 1,
      "per_page": 20,
      "total": 42
    }
  }
}

GET /api/v1/orders/{order_id} Récupérer une commande individuelle

Endpoint : informations produit et commande

GET /api/v1/orders/{order_id}/codes Toutes les informations produit d'une commande

Beispiel-Response

{
  "success": true,
  "data": {
    "order_id": "ORD-12345",
    "codes": [
      {
        "id": "CODE-789",
        "product_name": "Beispielprodukt vom Marktplatz",
        "product_sku": "ART-PRODUCT-001",
        "product_info": "Hinweise laut Verkäuferangaben",
        "delivery_url": "https://...",
        "delivered_at": "2026-01-15T10:31:00Z",
        "status": "active"
      }
    ]
  }
}

GET /api/v1/codes/{code_id} Récupérer une information produit individuelle

warning Les informations produit et commande ne peuvent être utilisées que dans le cadre de la commande et des informations vendeur correspondantes. Une transmission abusive peut enfreindre les conditions d'utilisation.

Endpoint : produits

GET /api/v1/products Récupérer le catalogue de produits

Parameter	Type	Description
`category`	string	Filtrer par slug de catégorie
`in_stock`	boolean	Uniquement les produits disponibles
`page`	integer	Page

Beispiel-Response

{
  "success": true,
  "data": {
    "products": [
      {
        "id": 42,
        "sku": "ART-PRODUCT-001",
        "name": "Beispielprodukt vom Marktplatz",
        "price": 49.99,
        "currency": "EUR",
        "in_stock": true,
        "category": "handmade"
      }
    ]
  }
}

Webhooks

Les Webhooks permettent de recevoir des notifications en temps réel lorsque des commandes ou des codes sont mis à disposition. Les URL de Webhook peuvent être enregistrées dans le compte client.

Événements disponibles

Event	Description
`order.paid`	La commande a été payée
`codes.delivered`	Les codes ont été mis à disposition
`order.refunded`	La commande a été remboursée

Webhook Payload

POST – Votre endpoint Webhook

{
  "event": "codes.delivered",
  "timestamp": "2026-01-15T10:31:05Z",
  "data": {
    "order_id": "ORD-12345",
    "codes_count": 2
  },
  "signature": "sha256=..."
}

Vérifiez la signature avec votre Webhook-Secret : HMAC-SHA256(payload, webhook_secret)

Questions fréquentes

Qui peut utiliser l'API B2B ?

Tout client disposant d'un compte client peut utiliser l'accès API. Connectez-vous à votre compte client et utilisez l'API-Key associée pour les requêtes authentifiées.

Quel format ont les réponses ?

Toutes les réponses sont renvoyées au format JSON. L'objet racine contient toujours success: true/false ainsi que soit data soit error.

Puis-je passer des commandes via l'API ?

Dans la première version, l'API sert à récupérer les commandes ainsi que les informations de commande et de produit. Les endpoints de commande en écriture seront activés séparément dès qu'ils seront disponibles.

Existe-t-il un environnement Sandbox ?

Oui. La Sandbox peut être activée dans le compte client dans l'onglet « Accès API » et est directement liée à l'API-Key correspondante.