Documentation API
Référence complète de l'API de synchronisation produits RackList
Authentification
Toutes les requêtes API nécessitent un header Authorization avec votre clé API au format Bearer token. Les clés API commencent par le préfixe rk_.
Authorization: Bearer YOUR_API_KEYFormat de clé : rk_ suivi de 64 caractères hexadécimaux (67 caractères au total)
Endpoint
/api/v1/sync/products
Synchronise les produits de votre système de facturation vers votre fiche RackList. Envoie un tableau de produits qui seront créés, mis à jour ou désactivés.
Headers requis
| Header | Valeur | Requis |
|---|---|---|
| Authorization | Bearer rk_... | Oui |
| Content-Type | application/json | Oui |
Rate Limits
1 requête par 5 minutes par hébergeur (fenêtre glissante)
Schéma du payload
Le payload JSON doit contenir un tableau products avec les champs suivants pour chaque produit :
| Champ | Type | Requis | Description |
|---|---|---|---|
| name | string | Oui | Nom du produit |
| external_id | string | Oui | Identifiant unique dans votre système de facturation |
| category | string | Oui | Catégorie du produit (ex: vps_cloud, game_minecraft) |
| price | float | Non | Prix mensuel |
| currency | string | Non | Devise (ISO 4217, ex: EUR, USD) |
| description | string | Non | Description du produit |
| specs | object | Non | Spécifications techniques (clé-valeur) |
| pricing_tiers | array | Non | Paliers de prix (période + prix) |
| setup_fee | float | Non | Frais d'installation |
| contract_duration | string | Non | Durée d'engagement |
| features | array | Non | Liste des fonctionnalités incluses |
| datacenter_locations | array | Non | Localisations des datacenters |
Exemple de payload
{
"products": [
{
"name": "VPS Cloud S",
"external_id": "prod_123",
"category": "vps_cloud",
"price": 4.99,
"currency": "EUR",
"description": "1 vCPU, 2GB RAM, 20GB SSD",
"specs": {
"cpu": "1 vCPU",
"ram": "2 GB",
"storage": "20 GB SSD"
},
"pricing_tiers": [
{"period": "monthly", "price": 4.99},
{"period": "yearly", "price": 49.90}
],
"features": ["DDoS Protection", "IPv6"],
"datacenter_locations": ["Paris", "Frankfurt"]
}
]
}Codes d'erreur
| Code | Description | Code d'erreur |
|---|---|---|
| 401 | Clé API invalide ou manquante | UNAUTHORIZED |
| 403 | Clé API révoquée ou inactive | KEY_REVOKED |
| 422 | Payload invalide - erreurs de validation | VALIDATION_FAILED |
| 429 | Trop de requêtes - rate limit dépassé | RATE_LIMITED |
| 500 | Erreur serveur interne | INTERNAL_ERROR |
Tester votre clé API
Utilisez cette commande cURL pour tester votre intégration :
curl -X POST https://racklist.eu/api/v1/sync/products \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"products": [{"name": "Test Product", "external_id": "test_1", "category": "vps_cloud"}]}'Remplacez YOUR_API_KEY par votre clé API pour tester.