Guide d'intégration API DataScribe

curl -X POST https://preprod.datascribe.app/api/client/upload \ -H "Authorization: Bearer ds_live_votre_cle_api" \ -F "file=@document.pdf" \ -F "webhook_url=https://votre-app.com/webhook"

{ "event": "document.completed", "documentId": "doc_abc123def456", "status": "completed", "timestamp": "2024-01-15T10:30:03Z", "result": { "message": "Document processed successfully", "pageCount": 2, "processingTime": 3.0 } }

// Installation : npm install axios form-data const axios = require('axios'); const FormData = require('form-data'); const fs = require('fs'); async function uploadDocument(filePath, webhookUrl) { const formData = new FormData(); formData.append('file', fs.createReadStream(filePath)); if (webhookUrl) { formData.append('webhook_url', webhookUrl); } try { const response = await axios.post( 'https://preprod.datascribe.app/api/client/upload', formData, { headers: { ...formData.getHeaders(), 'Authorization': 'Bearer ds_live_votre_cle_api' } } ); console.log('Document uploadé:', response.data); return response.data.documentId; } catch (error) { console.error('Erreur:', error.response?.data || error.message); } } // Utilisation uploadDocument('./facture.pdf', 'https://votre-app.com/webhook') .then(documentId => { console.log('Document ID:', documentId); });

# Installation : pip install requests import requests import time class DataScribeClient: def __init__(self, api_key): self.api_key = api_key self.base_url = 'https://preprod.datascribe.app/api' self.headers = { 'Authorization': f'Bearer {api_key}' } def upload_document(self, file_path, webhook_url=None): """Upload un document pour traitement""" with open(file_path, 'rb') as file: files = {'file': file} data = {} if webhook_url: data['webhook_url'] = webhook_url response = requests.post( f'{self.base_url}/client/upload', headers=self.headers, files=files, data=data ) if response.status_code == 200: return response.json() else: raise Exception(f"Erreur: {response.text}") def get_document_status(self, document_id): """Récupère le statut d'un document""" response = requests.get( f'{self.base_url}/client/documents/{document_id}', headers=self.headers ) if response.status_code == 200: return response.json() else: raise Exception(f"Erreur: {response.text}") def wait_for_completion(self, document_id, timeout=60): """Attend la fin du traitement d'un document""" start_time = time.time() while time.time() - start_time < timeout: status = self.get_document_status(document_id) if status['document']['status'] == 'completed': return status elif status['document']['status'] == 'failed': raise Exception("Le traitement a échoué") time.sleep(2) # Attendre 2 secondes avant de réessayer raise Exception("Timeout: le traitement prend trop de temps") # Utilisation client = DataScribeClient('ds_live_votre_cle_api') # Upload d'un document result = client.upload_document('facture.pdf') document_id = result['documentId'] print(f"Document uploadé: {document_id}") # Attendre la fin du traitement final_status = client.wait_for_completion(document_id) print("Traitement terminé:", final_status)

<?php class DataScribeClient { private $apiKey; private $baseUrl = 'https://preprod.datascribe.app/api'; public function __construct($apiKey) { $this->apiKey = $apiKey; } public function uploadDocument($filePath, $webhookUrl = null) { $curl = curl_init(); $postData = [ 'file' => new CURLFile($filePath) ]; if ($webhookUrl) { $postData['webhook_url'] = $webhookUrl; } curl_setopt_array($curl, [ CURLOPT_URL => $this->baseUrl . '/client/upload', CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true, CURLOPT_POSTFIELDS => $postData, CURLOPT_HTTPHEADER => [ 'Authorization: Bearer ' . $this->apiKey ] ]); $response = curl_exec($curl); $httpCode = curl_getinfo($curl, CURLINFO_HTTP_CODE); curl_close($curl); if ($httpCode == 200) { return json_decode($response, true); } else { throw new Exception("Erreur HTTP $httpCode: $response"); } } public function getDocumentStatus($documentId) { $curl = curl_init(); curl_setopt_array($curl, [ CURLOPT_URL => $this->baseUrl . '/client/documents/' . $documentId, CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => [ 'Authorization: Bearer ' . $this->apiKey ] ]); $response = curl_exec($curl); $httpCode = curl_getinfo($curl, CURLINFO_HTTP_CODE); curl_close($curl); if ($httpCode == 200) { return json_decode($response, true); } else { throw new Exception("Erreur HTTP $httpCode: $response"); } } } // Utilisation $client = new DataScribeClient('ds_live_votre_cle_api'); try { // Upload d'un document $result = $client->uploadDocument('facture.pdf', 'https://votre-app.com/webhook'); $documentId = $result['documentId']; echo "Document uploadé: $documentId "; // Vérifier le statut sleep(5); // Attendre 5 secondes $status = $client->getDocumentStatus($documentId); echo "Statut: " . $status['document']['status'] . " "; } catch (Exception $e) { echo "Erreur: " . $e->getMessage() . " "; } ?>