L'API REST complète de PROCUREF pour intégrer vos systèmes.
Tous les endpoints marqués 🔒 nécessitent un token JWT dans le header Authorization.
Authorization: Bearer votre_token_jwtLe token est obtenu via POST /api/v1/auth/login/. Il expire après 15 minutes. Utilisez le refresh token pour le renouveler.
Chaque organisation a son sous-domaine. L'API est accessible via le sous-domaine de l'organisation.
https://votre-org.procuref.com/api/v1//api/v1/auth/login/PublicAuthentification - Obtient un token JWT
Request Body:
{
"email": "user@org.com",
"password": "******"
}Response:
{
"access": "eyJ...",
"refresh": "eyJ...",
"user": {...},
"tenant_domain": "org.procuref.com"
}/api/v1/auth/register/PublicInscription - Crée une organisation et un admin
Request Body:
{
"organization_name": "Mon ONG",
"organization_slug": "mon-ong",
"first_name": "Jean",
"last_name": "Dupont",
"email": "jean@ong.org",
"password": "******"
}Response:
{
"message": "Organisation créée avec succès",
"tenant_domain": "mon-ong.localhost:3000",
"user": {...}
}/api/v1/requisitions/ AuthentifiéListe toutes les réquisitions
Response:
{
"count": 42,
"results": [...]
}/api/v1/requisitions/ AuthentifiéCrée une nouvelle réquisition
Request Body:
{
"department": 1,
"project": 1,
"description": "...",
"purchase_type": "direct",
"items": [...]
}Response:
{
"id": 1,
"requisition_number": "REQ-2026-001",
"status": "draft"
}/api/v1/suppliers/ AuthentifiéListe tous les fournisseurs
Response:
{
"count": 15,
"results": [...]
}/api/v1/purchase-orders/ AuthentifiéListe tous les bons de commande
Response:
{
"count": 8,
"results": [...]
}/api/v1/reception/grn/ AuthentifiéListe tous les bons de réception
Response:
{
"count": 5,
"results": [...]
}/api/v1/reports/dashboard/stats/ AuthentifiéStatistiques globales du dashboard
Response:
{
"total_requisitions": 42,
"total_amount": 150000
}L'URL de base de l'API dépend de votre environnement :
http://localhost:8000/api/v1/https://[votre-org].procuref.com/api/v1/