Documentation Cexro OCR
Tout ce dont vous avez besoin pour commencer avec notre API OCR
Guide de démarrage
Configurez votre compte et effectuez votre premier appel API
Référence API
Documentation complète de tous les endpoints disponibles
Exemples de code
Exemples prêts à l'emploi en Python, JavaScript, PHP
Commencer rapidement
1. Authentification
Toutes les requêtes API nécessitent une clé d'authentification. Vous pouvez obtenir votre clé API dans votre tableau de bord.
curl -X POST https://api.cexro.com/v1/ocr \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: multipart/form-data" \
-F "file=@facture.pdf"
2. Upload et traitement
Envoyez vos fichiers PDF, JPEG ou PNG à notre endpoint OCR. La réponse contient les données extraites au format JSON.
3. Formats supportés
- PDF - Factures scannées ou numériques
- JPEG/JPG - Images haute résolution
- PNG - Captures d'écran ou scans
- TIFF - Documents professionnels
4. Réponse API
{ "status": "success", "confidence": 0.98, "data": { "invoice_number": "FAC-2025-001", "date": "2025-01-15", "total_amount": 1250.00, "currency": "MAD", "vendor": { "name": "Entreprise ABC", "phone": "0706058056" }, "items": [ { "description": "Service consultation", "quantity": 1, "unit_price": 1250.00, "total": 1250.00 } ] } }
Fonctionnalités avancées
Personnalisation
Configurez les champs à extraire selon vos besoins métier
Sécurité
Chiffrement SSL, conformité RGPD et stockage sécurisé
Limites et quotas
Plan Gratuit : 10 requêtes/mois
Plan Pro : 500 requêtes/mois
Plan Enterprise : Illimité
Exemples de code complets
Python avec requests
import requests import json # Configuration api_key = "votre_cle_api" url = "https://api.cexro.com/v1/ocr" # Headers headers = { "Authorization": f"Bearer {api_key}", "Content-Type": "multipart/form-data" } # Upload et traitement with open("facture.pdf", "rb") as file: files = {"file": file} response = requests.post(url, headers=headers, files=files) if response.status_code == 200: result = response.json() print(f"Numéro facture: {result['data']['invoice_number']}") print(f"Montant total: {result['data']['total_amount']} MAD") else: print(f"Erreur: {response.status_code}")
JavaScript/Node.js
const FormData = require('form-data'); const fs = require('fs'); const axios = require('axios'); async function processInvoice(filePath) { const form = new FormData(); form.append('file', fs.createReadStream(filePath)); try { const response = await axios.post('https://api.cexro.com/v1/ocr', form, { headers: { 'Authorization': 'Bearer votre_cle_api', ...form.getHeaders() } }); console.log('Données extraites:', response.data.data); return response.data; } catch (error) { console.error('Erreur:', error.response?.data || error.message); } } // Utilisation processInvoice('./facture.pdf');
PHP avec cURL
<?php $api_key = "votre_cle_api"; $file_path = "facture.pdf"; $curl = curl_init(); curl_setopt_array($curl, array( CURLOPT_URL => 'https://api.cexro.com/v1/ocr', CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true, CURLOPT_HTTPHEADER => array( 'Authorization: Bearer ' . $api_key ), CURLOPT_POSTFIELDS => array( 'file' => new CURLFile($file_path) ) )); $response = curl_exec($curl); $http_code = curl_getinfo($curl, CURLINFO_HTTP_CODE); curl_close($curl); if ($http_code == 200) { $data = json_decode($response, true); echo "Numéro facture: " . $data['data']['invoice_number'] . "\n"; echo "Montant: " . $data['data']['total_amount'] . " MAD\n"; } else { echo "Erreur HTTP: " . $http_code . "\n"; } ?>
Gestion des erreurs et codes de réponse
Codes de statut HTTP
- 200 OK - Traitement réussi, données extraites disponibles
- 400 Bad Request - Format de fichier non supporté ou fichier corrompu
- 401 Unauthorized - Clé API invalide ou expirée
- 413 Payload Too Large - Fichier trop volumineux (limite 50MB)
- 429 Too Many Requests - Quota API dépassé
- 500 Internal Server Error - Erreur temporaire du service
Optimisation et bonnes pratiques
✓ Bonnes pratiques
- • Utilisez des images de haute qualité (300 DPI minimum)
- • Évitez les documents flous ou mal éclairés
- • Préférez le format PDF pour les meilleurs résultats
- • Implémentez une gestion d'erreur robuste
- • Conservez votre clé API secrète et sécurisée
✗ À éviter
- • Ne partagez jamais votre clé API publiquement
- • N'envoyez pas de fichiers corrompus ou vides
- • Évitez les requêtes simultanées excessives
- • Ne stockez pas les clés API dans le code source
Architecture technique et infrastructure
L'API Cexro OCR repose sur une architecture cloud robuste et évolutive, spécialement conçue pour traiter de gros volumes de documents avec une disponibilité garantie de 99.9%.
Infrastructure de traitement
Nos serveurs de traitement OCR utilisent des algorithmes d'apprentissage automatique avancés combinés à des réseaux de neurones profonds pour garantir une précision maximale dans l'extraction de données. L'infrastructure est répartie sur plusieurs centres de données pour assurer une redondance complète et des temps de réponse optimaux.
Spécifications techniques
- Temps de traitement moyen : 2-5 secondes par document
- Formats supportés : PDF, JPEG, PNG, TIFF jusqu'à 50MB
- Résolution recommandée : 300 DPI minimum pour une qualité optimale
- Langues supportées : Français, Arabe, Anglais avec reconnaissance multilingue
- Taux de disponibilité : 99.9% garanti avec SLA
- Capacité de traitement : Jusqu'à 10,000 documents simultanés
Intégration avancée et webhooks
Pour les entreprises nécessitant un traitement en temps réel et une intégration poussée avec leurs systèmes existants, Cexro OCR propose des fonctionnalités avancées de webhook et de traitement asynchrone.
Configuration des webhooks
POST /v1/webhook/configure { "webhook_url": "https://votre-serveur.com/webhook", "events": ["document.processed", "document.failed"], "secret": "your_webhook_secret" }
Lorsqu'un document est traité, notre système enverra automatiquement les résultats à votre endpoint configuré, permettant une intégration transparente avec vos systèmes comptables ou ERP existants.
Sécurité et conformité des données
La sécurité des données de nos clients est notre priorité absolue. Tous les documents traités par l'API Cexro OCR bénéficient de mesures de sécurité de niveau entreprise :
🔒 Chiffrement des données
- • Chiffrement AES-256 en transit et au repos
- • Certificats SSL/TLS avec validation étendue
- • Clés de chiffrement rotatives automatiques
📋 Conformité réglementaire
- • Conformité RGPD pour la protection des données
- • Respect des normes comptables marocaines
- • Audit de sécurité trimestriel
Cas d'usage et secteurs d'activité
L'API Cexro OCR s'adapte à de nombreux secteurs d'activité au Maroc, chacun avec ses spécificités et besoins particuliers :
🏢 Cabinets d'expertise comptable
Automatisation complète du traitement des factures clients, réduction des erreurs de saisie de 95%, gain de temps de 80% sur les tâches répétitives.
Clients types : Cabinet Benjelloun, KPMG Maroc, Deloitte Casablanca
🏭 Grandes entreprises industrielles
Traitement de milliers de factures fournisseurs mensuelles, intégration directe avec SAP, Oracle ou systèmes ERP locaux.
Secteurs : Automobile, textile, agroalimentaire, BTP
🏪 PME et commerces
Solution clé en main pour digitaliser la comptabilité, conformité automatique aux obligations fiscales marocaines.
Idéal pour : Restaurants, magasins, services, professions libérales
Support technique et assistance
Notre équipe technique experte est disponible pour vous accompagner dans l'intégration et l'utilisation de l'API Cexro OCR. Nous proposons plusieurs niveaux de support adaptés à vos besoins :
Support Email Premium
contact@cexro.ma
Réponse sous 4h en moyenne, documentation détaillée fournie, exemples de code personnalisés
- • Aide à l'intégration API complète
- • Résolution des problèmes techniques
- • Optimisation des performances
Support Téléphonique Dédié
+212 706 058 056
Lun-Ven 9h-18h, assistance technique en français et arabe, ingénieurs dédiés
- • Support en temps réel
- • Configuration personnalisée
- • Formation utilisateurs
Formation et ressources développeurs
Cexro OCR met à disposition de nombreuses ressources pour faciliter l'adoption et maîtriser pleinement notre API :
🎓 Programme de formation développeurs
Sessions gratuites :
- • Webinaires mensuels sur les nouveautés
- • Ateliers d'intégration pratiques
- • Bootcamp OCR pour débutants
Ressources techniques :
- • SDK officiels Python, PHP, Node.js
- • Collections Postman prêtes à l'emploi
- • Exemples de code GitHub
Prêt à commencer ?
Obtenez votre clé API et commencez à traiter vos factures en quelques minutes
Commencer maintenant