API · Développeurs

API Partenaires

Intégrez l'intégralité du catalogue Total Acces sur votre boutique ou marketplace, et transmettez les commandes de vos clients. Les prix renvoyés incluent déjà la marge Total Acces — ajoutez la vôtre par-dessus.

Demander une clé APIURL de base: https://total-acces.com/api/partner/v1

Démarrage rapide

Trois étapes pour afficher le catalogue et passer une première commande de test.

1. Obtenez votre clé

Contactez-nous pour recevoir votre clé API partenaire (préfixe ta_live_). Elle identifie votre compte et vos conditions.

2. Récupérez le catalogue

Interrogez le catalogue produit par produit, ou tirez le flux complet (JSON/CSV) pour l'importer chez vous.

3. Transmettez les commandes

Chaque commande envoyée arrive chez Total Acces sous forme de devis à confirmer, puis expédiée dans le pays du client.

Authentification

Toutes les requêtes exigent votre clé API dans l'en-tête Authorization (jeton Bearer). Ne l'exposez jamais côté navigateur : les appels se font depuis votre serveur.

curl -H "Authorization: Bearer ta_live_..." \
  "https://total-acces.com/api/partner/v1/products?pageSize=5"

Limites de débit

120 requêtes par minute et par partenaire. Au-delà, l'API renvoie 429 RATE_LIMITED — réessayez après une courte pause.

Catalogue

Liste paginée des produits publiés (avec image). Filtrable par recherche, marque et catégorie ; renvoie aussi les facettes disponibles.

GET/products

Paramètres de requête

Paramètre	Description
`page`	Numéro de page (défaut 1).
`pageSize`	Produits par page (1 à 100, défaut 50).
`q`	Recherche plein texte (nom, référence, marque).
`brand`	Filtre par marque.
`category`	Filtre par catégorie.
`sort`	Tri : relevance (défaut), brand ou category.

Réponse

{
  "items": [
    {
      "reference": "PER760",
      "name": "Serveur rack 2U",
      "brand": "Dell",
      "category": "Serveurs",
      "price_eur": 4890.00,
      "currency": "EUR",
      "available": true,
      "image_url": "https://images.icecat.biz/...jpg",
      "slug": "serveur-rack-2u"
    }
  ],
  "page": 1,
  "pageSize": 50,
  "total": 12493,
  "facets": { "brands": ["APC", "Cisco", "..."], "categories": ["Serveurs", "..."] }
}

Détail d'un produit

Renvoie un seul produit par sa référence. 404 si la référence est inconnue ou non publiée.

GET/products/{reference}

Flux catalogue complet

Tout le catalogue publié en un seul appel, en JSON ou CSV (format compatible marketplaces / Google Merchant). Mis en cache 1 heure — idéal pour un import planifié quotidien.

GET/feed/json

GET/feed/csv

# CSV (compatible marketplaces / Google Merchant)
id,title,brand,product_type,price,availability,image_link,link

Commandes

Transmettez une commande client. Le prix de chaque ligne est recalculé côté serveur ; la commande arrive chez Total Acces en tant que devis, qui la confirme. Suivez ensuite son statut par son identifiant.

POST/orders

POST /api/partner/v1/orders
{
  "partner_reference": "VOTRE-REF-123",
  "items": [{ "reference": "PER760", "quantity": 2 }],
  "customer": {
    "name": "Client SARL",
    "email": "achat@client.com",
    "country": "BF",
    "address": "..."
  }
}
→ 201 Created  (la commande arrive en devis chez Total Acces)

Suivi d'une commande

GET/orders/{id}

Objet produit

Chaque produit renvoyé par le catalogue et les flux a la forme suivante :

Champ	Description
`reference`	Référence unique du produit (identifiant stable).
`name`	Nom commercial du produit.
`brand`	Marque (peut être nulle).
`category`	Catégorie (peut être nulle).
`price_eur`	Prix de vente HT en EUR, marge Total Acces incluse. 0 pour un produit sur devis.
`available`	true si le produit a un prix ferme ; false s'il est sur devis.
`image_url`	URL de l'image principale (peut être nulle).
`slug`	Identifiant d'URL pour le lien vers la fiche produit.

Prix & produits sur devis

Les prix incluent déjà la marge Total Acces : ajoutez votre propre marge par-dessus. Les produits sans prix ferme (serveurs configurables, gros volumes) reviennent avec price_eur = 0 et available = false — présentez-les « sur devis » chez vous ; la commande partira en devis.

Codes d'erreur

Code	Description
`401 INVALID_API_KEY`	Clé API absente, invalide ou révoquée.
`400 INVALID_BODY`	Corps de requête invalide (champs manquants).
`422 UNKNOWN_REFERENCE`	Une référence de la commande est inconnue.
`403 FORBIDDEN_SCOPE`	Clé non autorisée à passer des commandes (portée « catalogue seul »).
`429 RATE_LIMITED`	Limite de débit dépassée — réessayez plus tard.
`413 BODY_TOO_LARGE`	Corps de requête trop volumineux.

Prêt à intégrer le catalogue ?

Écrivez-nous pour obtenir votre clé API partenaire et vos conditions. Nous vous accompagnons pour la mise en place.

Demander une clé API