Données

Licence

Toutes les données de Cadrame sont dans le domaine public (CC0 1.0) : vous pouvez les copier, les modifier et les republier, même dans un produit commercial, sans demander ni citer. Les résumés de Wikipédia sont cités par un lien, jamais copiés.

Licence CC0

API

Une API JSON, sur https://cadrame.org. La lecture ne demande pas de compte ; les réponses peuvent être gardées en cache.

• GET /api/v1/entites/{id}Une fiche, avec ses affirmations et leurs sources.
• GET /api/v1/entites/{id}/historiqueL'historique d'une fiche, révision par révision.
• GET /api/v1/recherche?q=…La recherche par titre ou par nom, dans toutes les langues.
• GET /api/v1/ids/{propriete}/{valeur}Les fiches qui portent un identifiant, par exemple imdb_title_id/tt0083658.
• GET /api/v1/changements?depuis={rev}Tout ce qui a changé depuis une révision : de quoi tenir une copie à jour (depuis 0 pour tout).
• GET /api/v1/envois/{rev}Un envoi publié, en entier, avec son auteur et ses sources.
• GET /api/v1/registreLe registre des propriétés : codes, types, formats, libellés.
• GET /api/v1/concepts?nature=genreLes genres, les sortes de vidéos et les autres concepts d'une nature.
• POST /api/v1/identifierReconnaître des fichiers par leurs empreintes et leurs durées, sans compte et sans rien garder.
• POST /api/v1/envoisEnvoyer des contributions (une clé d'API).
• POST /api/v1/soumissionsEnvoyer les empreintes de fichiers vus (une clé d'API).

Pour écrire, créez une clé dans Votre compte → Applications connectées, puis envoyez-la dans l'en-tête « Authorization: Bearer cdr_… ». Les envois d'un compte en attente sont gardés jusqu'à sa validation.

Les formats (cadrame-envoi-1, cadrame-soumission-1, cadrame-identification-1) sont décrits par des schémas JSON, dans le domaine public ; ils seront publiés avec le code.

Archive mensuelle

Chaque mois, une archive complète et signée des données sera déposée sur Internet Archive. Elle n'existe pas encore : en attendant, /api/v1/changements?depuis=0 donne tout.

Code source

Le serveur sera publié sous AGPL-3.0 ; la bibliothèque d'empreintes, le client de l'API et la façade Stash-Box sous Apache-2.0 ; la documentation et la spécification sous CC0. Le dépôt est encore privé.