Aperçu de l'API
Un aperçu de haut niveau des endpoints publics de l'API OikosTV.
URL de Base
https://dev.api.crewvid.com/api/v1/Contenu et Découverte
| Méthode | Endpoint | Description |
|---|---|---|
GET | /videos/{shortUUID} | Récupérer des informations détaillées sur une vidéo spécifique |
GET | /channels/{handle} | Récupérer les détails de la chaîne, y compris le nombre d'abonnés et les métadonnées |
GET | /videos/{shortUUID}/playback | Obtenir le paquet de lecture (manifest + session JWT) pour une vidéo |
Monétisation et Récompenses
| Méthode | Endpoint | Description |
|---|---|---|
GET | /me/rewards/balance | Consulter votre solde actuel de PeerCredits |
POST | /rewards/redeem | Échanger des PeerCredits contre des heures de visionnage sans publicité |
GET | /studio/monetization/flags | Voir les fonctionnalités de monétisation activées pour une chaîne |
Authentification
Toutes les requêtes API doivent inclure un jeton de session valide dans l'en-tête Authorization :
http
Authorization: Bearer <session_token>Limitation de débit
Pour garantir la stabilité de la plateforme, tous les endpoints publics sont soumis à une limitation de débit. Veuillez implémenter un backoff exponentiel pour les tentatives.
Versioning
Nous utilisons des URLs versionnées (ex. : /api/v1/...) pour maintenir la compatibilité ascendante au fur et à mesure que l'API évolue. La version stable actuelle est v1.
Réponses d'Erreur
L'API retourne les erreurs dans un format cohérent :
json
{
"error": "Description de ce qui s'est mal passé"
}Codes de statut HTTP courants :
| Code | Signification |
|---|---|
400 | Mauvaise Requête — paramètres invalides |
401 | Non Autorisé — jeton manquant ou invalide |
403 | Interdit — permissions insuffisantes |
404 | Non Trouvé — la ressource n'existe pas |
429 | Trop de Requêtes — limite de débit dépassée |
500 | Erreur Interne du Serveur |
SDK disponible
Pour une intégration plus facile, utilisez le paquet @crewvid/outpost-sdk au lieu d'appeler l'API directement.