API Uveon - Pilotez votre réseau de points de vente

Une API RESTful complÚte développée avec Laravel 11 pour gérer vos points de vente, équipes, abonnements et statistiques en temps réel.

Fonctionnalités principales

Découvrez les capacités complÚtes de l'API Uveon pour gérer votre réseau de distribution

🔐

Authentification sécurisée

SystÚme d'authentification par téléphone avec tokens HMAC, OTP et historique des connexions pour une sécurité maximale.

Voir les endpoints
đŸȘ

Gestion des points de vente

Création, mise à jour et suivi complet des points de vente avec documents, horaires et équipes associées.

Voir les endpoints
📊

Statistiques et reporting

Widgets de statistiques configurables avec indicateurs de performance et progression pour chaque point de vente.

Voir les endpoints
💳

Abonnements et forfaits

Gestion complÚte des offres commerciales, validations opérateur et suivi des paiements avec calcul des jours restants.

Voir les endpoints
đŸ‘„

Gestion des utilisateurs et rĂŽles

SystÚme d'autorisations avancé avec menus dynamiques filtrés par rÎle et gestion des permissions.

Voir les endpoints
🔔

Temps réel avec WebSockets

Notifications en temps réel grùce à Laravel Reverb et Echo pour une expérience utilisateur réactive.

Voir les endpoints

Documentation API

Explorez les principaux endpoints disponibles dans l'API Uveon

Authentification

POST /api/login Connexion avec téléphone et mot de passe
POST /api/refresh-token RafraĂźchir le token d'authentification
POST /api/reset-password Demander une réinitialisation de mot de passe

Points de vente

GET /api/salepoints Lister tous les points de vente
POST /api/salepoints Créer un nouveau point de vente
GET /api/salepoints/{id} Récupérer un point de vente spécifique
PUT /api/salepoints/{id} Mettre Ă  jour un point de vente

Statistiques

GET /api/statistics/{salepoint_id}/{period} Récupérer les statistiques d'un PDV
GET /api/statistics/{ref} Récupérer les statistiques par référence

Démarrage rapide

Intégrez l'API Uveon en quelques étapes simples

1. Authentification

Commencez par obtenir un token d'authentification :

// RequĂȘte d'authentification
POST /api/login
{
  "phone": "+2250123456789",
  "password": "votre_mot_de_passe"
}

// Réponse
{
  "success": true,
  "data": {
    "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
    "user": { ... }
  }
}

2. Utiliser le token

Incluez le token dans l'en-tĂȘte de vos requĂȘtes :

// Exemple avec JavaScript
const response = await fetch('/api/salepoints', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer ' + token,
    'Content-Type': 'application/json'
  }
});

3. Récupérer les points de vente

// RequĂȘte pour lister les points de vente
GET /api/salepoints?page=1&per_page=10

// Réponse
{
  "success": true,
  "data": {
    "current_page": 1,
    "data": [
      {
        "id": 1,
        "name": "PDV Abidjan Centre",
        "id_uveon": "UV-ABJ-001",
        "status": "active",
        ...
      }
    ],
    "total": 150
  }
}