API REST v1.0

API Al-Rafiq pour Développeurs

Intégrez la puissance d'Al-Rafiq dans vos applications avec notre API REST complète, sécurisée et bien documentée.

Rapide & Fiable

99.9% de disponibilité avec des temps de réponse optimisés

Sécurisée

Authentification OAuth 2.0 et chiffrement SSL/TLS

Bien Documentée

Documentation complète avec exemples de code

Démarrage Rapide

Intégrez Al-Rafiq en quelques minutes

1

Obtenez votre clé API

Connectez-vous à votre compte et générez une clé API dans les paramètres.

2

Configurez l'authentification

Utilisez OAuth 2.0 ou une clé API directe selon vos besoins.

3

Faites votre première requête

Testez l'API avec une simple requête GET pour récupérer vos données.

example.js
// Configuration
const API_KEY = 'your_api_key_here';
const BASE_URL = 'https://api.alrafiq.dz/v1';

// Récupérer la liste des factures
async function getInvoices() {
  const response = await fetch(`${BASE_URL}/invoices`, {
    method: 'GET',
    headers: {
      'Authorization': `Bearer ${API_KEY}`,
      'Content-Type': 'application/json'
    }
  });
  
  const data = await response.json();
  return data.invoices;
}

// Créer une nouvelle facture
async function createInvoice(clientId, items) {
  const response = await fetch(`${BASE_URL}/invoices`, {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${API_KEY}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      client_id: clientId,
      items: items,
      due_date: '2026-04-30'
    })
  });
  
  return await response.json();
}

Points de Terminaison

Toutes les ressources disponibles via l'API

GET POST PUT DELETE

/invoices

Gérez vos factures : création, modification, suppression et récupération.

Voir la documentation →
GET POST PUT

/clients

Gestion complète de votre base clients.

Voir la documentation →
GET POST PUT

/products

Catalogue produits et services avec gestion des stocks.

Voir la documentation →
GET POST

/payments

Enregistrez et suivez les paiements reçus.

Voir la documentation →

Webhooks en Temps Réel

Recevez des notifications instantanées lorsque des événements se produisent dans votre compte Al-Rafiq.

  • Nouvelle facture créée
  • Paiement reçu
  • Client mis à jour
  • Stock faible
// Exemple de payload webhook
{
  "event": "invoice.paid",
  "timestamp": "2026-03-31T19:45:00Z",
  "data": {
    "invoice_id": "INV-2026-001",
    "client": {
      "id": "12345",
      "name": "Tech Solutions",
      "email": "contact@techsol.dz"
    },
    "amount": 45000,
    "currency": "DZD",
    "payment_method": "card",
    "paid_at": "2026-03-31T19:45:00Z"
  }
}

SDK Officiels

Bibliothèques prêtes à l'emploi pour les langages populaires

🐘

PHP

Composer package pour PHP 7.4+

composer require alrafiq/api
🐍

Python

Package PyPI pour Python 3.7+

pip install alrafiq-api

Node.js

Package NPM pour Node 14+

npm install @alrafiq/api

Prêt à développer ?

Obtenez votre clé API et commencez à intégrer Al-Rafiq dès maintenant.