Mon Blog
Documentation API Produits Utilisateur – Version 1.5

Documentation Complète de l’API – Produits Utilisateur

Version : 1.5 | Auteur : DG bunker EQ DEV | Préparée pour : digi-bunkers.com

📦 Description

Cette API permet l’enregistrement et la gestion des produits des utilisateurs via une requête REST, en mettant à jour leur solde et en exécutant un webhook une fois la livraison effectuée.

🛠️ Installation

Téléchargez le plugin et placez le fichier dans :

/wp-content/plugins/api-produits-utilisateur/api-produits-utilisateur.php

Activez le plugin via le tableau de bord WordPress.

🔑 API Key Automatique

Chaque utilisateur connecté reçoit automatiquement une clé API unique stockée dans la métadonnée :

custom_api_key

📡 API Endpoint REST

POST /wp-json/custom-api/v1/add-product/

🔐 Authentification : Nécessite une clé API valide (envoyée dans le corps JSON).

📥 Paramètres JSON requis

Clé Type Description
api_key string Clé API de l’utilisateur
product string Nom du produit
balance float Solde pour un article (ex : 5.00)
quantity int Quantité demandée
currency string Devise (ex : USD, EUR)
client_email string Email du client final

🎯 Exemple d’appel


curl -X POST https://digi-bunkers.com/wp-json/custom-api/v1/add-product/ \
-H "Content-Type: application/json" \
-d '{
    "api_key": "VOTRE_API_KEY",
    "product": "PlayStation Gift Card",
    "balance": 20.00,
    "quantity": 2,
    "currency": "USD",
    "client_email": "client@example.com"
}'

✅ Réponse (succès)


{
  "success": "Produit ajouté avec succès",
  "new_wallet_balance": 40.00
}

❌ Réponses d’erreur possibles

🔄 Webhook Automatique (après livraison)

Une fois le produit ajouté, un webhook est déclenché vers l’URL :

https://digi-bunkers.com/api/webhook/

Payload envoyé :


{
    "user_id": 12,
    "product_name": "PlayStation Gift Card",
    "quantity": 2,
    "total_balance": 20.00,
    "currency": "USD",
    "client_email": "client@example.com"
}

⚙️ Hooks & Filtres WordPress utilisés

💡 Notes Importantes