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