🚀 API CinéAvis

Documentation de l'API publique v1.0

📋 Introduction

L'API CinéAvis permet aux développeurs d'accéder aux données de films, critiques et utilisateurs de la plateforme. Toutes les requêtes nécessitent une clé API.

Base URL: https://cineavis.com/api/v1

🔑 Authentification

Incluez votre clé API dans l'en-tête X-API-Key ou comme paramètre api_key.

# Via en-tête
curl -H "X-API-Key: YOUR_API_KEY" https://cineavis.com/api/v1/movies

# Via paramètre
curl "https://cineavis.com/api/v1/movies?api_key=YOUR_API_KEY"

📊 Rate Limiting

Chaque clé API a une limite quotidienne de requêtes (configurable par l'administrateur). La limite par défaut est de 1000 requêtes par jour.

Important: Si vous dépassez la limite, vous recevrez une réponse HTTP 429.

🎬 Endpoints

Lister les films populaires

GET /movies
Paramètre Type Description
page integer Numéro de page (défaut: 1)
limit integer Résultats par page (1-50, défaut: 20) 
curl -H "X-API-Key: YOUR_API_KEY" "https://cineavis.com/api/v1/movies?page=1&limit=20"

Détails d'un film

GET /movies/{id} 
curl -H "X-API-Key: YOUR_API_KEY" "https://cineavis.com/api/v1/movies/123"

Lister les critiques

GET /reviews
Paramètre Type Description
page integer Numéro de page (défaut: 1)
limit integer Résultats par page (1-50, défaut: 20) 
curl -H "X-API-Key: YOUR_API_KEY" "https://cineavis.com/api/v1/reviews?page=1&limit=20"

Détails d'une critique

GET /reviews/{id} 
curl -H "X-API-Key: YOUR_API_KEY" "https://cineavis.com/api/v1/reviews/456"

Profil utilisateur

GET /users/{id}
Note: Seuls les profils publics sont accessibles via l'API. 
curl -H "X-API-Key: YOUR_API_KEY" "https://cineavis.com/api/v1/users/789"

Rechercher des films

GET /search
Paramètre Type Description
q string Requis Terme de recherche
limit integer Nombre de résultats (1-20, défaut: 10) 
curl -H "X-API-Key: YOUR_API_KEY" "https://cineavis.com/api/v1/search?q=inception&limit=10"

📦 Réponses

Structure de réponse

Toutes les réponses réussies suivent ce format:

{
  "success": true,
  "data": { ... },
  "rate_limit": {
    "remaining": 999
  }
}

Codes d'erreur

Code Description
400 Requête invalide
401 Clé API manquante ou invalide
404 Ressource non trouvée
429 Limite de taux dépassée
500 Erreur serveur interne

⚖️ Conditions d'utilisation

L'utilisation de l'API CinéAvis est soumise aux conditions suivantes:

  • L'API est fournie gratuitement à des fins non commerciales
  • Respectez les limites de taux imposées
  • Ne pas utiliser l'API pour du scraping massif
  • Attribuez CinéAvis comme source des données
  • L'API peut être modifiée ou interrompue sans préavis
Important: Pour toute utilisation commerciale ou pour des limites plus élevées, contactez-nous via le formulaire de contact.

📞 Support

Pour obtenir une clé API ou pour toute question technique: