Documentation API

Intégrez la compression d'images CompressImage - Artevotade dans vos applications

REST APIPlan Pro uniquement
Introduction

L'API CompressImage - Artevotade vous permet de compresser des images par programmation. Elle est accessible uniquement avec un abonnement Pro.

💡 URL de base

https://compress.artevotade.com/api
Authentification

L'API utilise une authentification par clé API (Bearer Token). Incluez votre clé dans l'en-tête Authorization de chaque requête.

Obtenir votre clé API

  1. Connectez-vous à votre compte Pro
  2. Accédez à « Paramètres » → « API »
  3. Générez ou copiez votre clé API
Header
Authorization: Bearer ci_live_xxxxxxxxxxxxxxxxxxxx

Sécurité

Ne partagez jamais votre clé API. Si elle est compromise, régénérez-la immédiatement depuis votre espace client.

Endpoints
POST/compress

Compresse une image et retourne l'image compressée.

Paramètres

ParamètreTypeRequisDescription
fileFileOuiImage à compresser (PNG, JPEG, WebP)
qualityIntegerNonQualité (1-100). Défaut: 80
formatStringNonFormat de sortie (jpeg, png, webp)

Réponse

JSON
{
  "success": true,
  "data": {
    "originalSize": 2048576,
    "compressedSize": 614400,
    "compressionRatio": 70,
    "format": "jpeg",
    "width": 1920,
    "height": 1080
  },
  "image": "base64_encoded_image_data..."
}

Codes d'erreur

400Paramètres invalides ou fichier manquant
401Clé API invalide ou manquante
413Fichier trop volumineux (max 50 Mo)
429Limite de requêtes dépassée
Limites de requêtes

Les limites dépendent de votre plan d'abonnement :

Plan Gratuit

  • API non accessible

Plan Pro

  • 1000 requêtes/jour
  • 100 requêtes/minute
  • 50 Mo max par image
Exemples de code

cURL

bash
curl -X POST https://compress.artevotade.com/api/compress \
  -H "Authorization: Bearer ci_live_xxxxxxxxxxxxxxxxxxxx" \
  -F "file=@image.png" \
  -F "quality=80" \
  -o compressed.jpg

JavaScript (Fetch)

javascript
const FormData = require('form-data');
const fs = require('fs');

const formData = new FormData();
formData.append('file', fs.createReadStream('image.png'));
formData.append('quality', '80');

const response = await fetch('https://compress.artevotade.com/api/compress', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer ci_live_xxxxxxxxxxxxxxxxxxxx',
  },
  body: formData
});

const result = await response.json();
console.log('Compression:', result.data.compressionRatio + '%');

Python

python
import requests

url = "https://compress.artevotade.com/api/compress"
headers = {"Authorization": "Bearer ci_live_xxxxxxxxxxxxxxxxxxxx"}

with open("image.png", "rb") as f:
    files = {"file": f}
    data = {"quality": 80}
    
    response = requests.post(url, headers=headers, files=files, data=data)
    result = response.json()
    
    print(f"Compression: {result['data']['compressionRatio']}%")
    
    # Save compressed image
    import base64
    with open("compressed.jpg", "wb") as out:
        out.write(base64.b64decode(result["image"]))
SDK officiel

Un SDK JavaScript/TypeScript officiel est disponible pour une intégration simplifiée :

bash
npm install @compressimage/sdk
typescript
import { CompressImage } from '@compressimage/sdk';

const client = new CompressImage({
  apiKey: 'ci_live_xxxxxxxxxxxxxxxxxxxx'
});

const result = await client.compress({
  file: './image.png',
  quality: 80,
  format: 'jpeg'
});

console.log('Saved:', result.compressionRatio + '%');
await result.save('./compressed.jpg');
Support API

Pour toute question technique ou problème avec l'API :

Email : contact@artevotade.com

Réponse : Sous 24h ouvrées

Prêt à intégrer l'API ?