Développeurs

Développez à partir de votre photothèque

Une API REST, des webhooks sortants, un serveur MCP pour les agents IA, des lecteurs intégrables, le Freedam Picker et un SDK TypeScript typé pour connecter Freedam à votre CMS, à vos outils d'automatisation et à vos applications internes.

Ouvrir la référence de l'API Essayer le produit

Cinq façons d'intégrer Freedam

Choisissez celle qui correspond à votre cas d'usage. La plupart des intégrations en combinent deux ou trois.

API REST

Une API HTTP versionnée, uniquement en JSON, pour les médias, les collections, les imports, les partages, les métadonnées et les opérations. Authentification par token avec des scopes détaillés.

Webhooks

Abonnez-vous à quatorze événements, livrés en temps réel. Les payloads sont signés, les livraisons en échec sont relancées, chaque livraison est journalisée et les secrets peuvent être renouvelés avec une période de grâce.

Serveur MCP

Connectez Freedam aux clients IA compatibles MCP. Les agents disposent de onze outils pour rechercher, organiser, importer et partager des médias, dans les limites des droits de leur token.

Vidéos intégrées

Intégrez n'importe quelle vidéo avec une seule iframe. Limitez la lecture à vos propres domaines et réglez la lecture automatique, la boucle, les sous-titres et le moment de départ.

Freedam Picker

Ajoutez à n'importe quelle application web un bouton qui ouvre Freedam pour choisir des médias. Un SDK sans dépendance ouvre le picker dans une fenêtre popup, un onglet, une fenêtre modale ou un panneau intégré, et renvoie des URL publiées, des points focaux et des métadonnées.

Les principes de la plateforme

Six principes qui rendent les intégrations faciles à maintenir.

Prévisible

Les requêtes et les réponses utilisent JSON. La version figure dans l'URL, et aucune modification incompatible n'intervient au sein d'une version majeure.

Droits limités par défaut

Chaque token d'API a sa propre liste de droits. Un token destiné aux imports ne peut pas supprimer, et un token en lecture seule ne peut pas partager. Un nouveau token n'a que les droits que vous lui donnez.

SDK typé

Le SDK TypeScript officiel couvre toute l'API, avec l'autocomplétion pour chaque endpoint, chaque paramètre et chaque réponse.

Piloté par les événements

Les modifications des médias, des collections, des partages, des imports et des workflows envoient des événements auxquels vous pouvez vous abonner : vos automatisations n'ont pas besoin d'interroger l'API en boucle.

Conçu pour les agents IA

Les agents IA se connectent via le serveur MCP intégré avec les mêmes tokens à droits limités : ils ont les mêmes permissions et sont enregistrés dans le même journal d'audit.

HTTP standard

Tout passe par des appels HTTP documentés dans la spécification OpenAPI.

Toujours à jour

Une référence conforme à l'API en service

La référence OpenAPI 3 disponible sur /docs/api est générée à partir de l'API servie en production : ses endpoints et ses exemples restent donc à jour. Vous pouvez tester des requêtes depuis la page, ou télécharger /docs/api.json pour l'utiliser avec l'outillage OpenAPI de votre choix.

Ouvrir la référence de l'API Télécharger la spécification OpenAPI

Démarrage rapide

Choisissez un point de départ.

Pour le frontend et le backend

Installer le SDK TypeScript

npm install @freedam/sdk

Pour les automatisations

S'abonner à un webhook

Réagissez en temps réel aux événements sur les médias, les collections et les workflows.

Pour les agents IA

Se connecter via MCP

Onze outils à droits limités pour les workflows agentiques.

Développeurs · Pour commencer

Connectez Freedam à vos outils

Commencez par la référence de l'API, ou ouvrez la démo et créez votre premier token.

Ouvrir la référence de l'API Essayer le produit