Documentation Transloadit
Ce guide vise à vous donner une compréhension claire de notre API et des concepts clés de notre plateforme. C’est parti !
Concepts clés
- Les Robots sont des outils qui effectuent des actions spécifiques sur des fichiers. Par exemple, le Robot 🤖/http/import peut importer des fichiers depuis n’importe quelle URL HTTP, le Robot 🤖/s3/store peut exporter des fichiers vers Amazon S3 et le Robot 🤖/video/encode peut redimensionner, convertir et filigraner des vidéos. Nous proposons 95 Robots pour tous vos besoins de traitement de fichiers.
- Les Templates sont des configurations au format JSON qui définissent ce qu’il faut faire de vos fichiers. Ces Instructions se composent de Steps qui utilisent chacun l’un de ces Robots. Les Templates sont stockés de manière sécurisée dans votre compte Transloadit. De nombreux exemples prêts à copier-coller vous aideront à démarrer.
- Les Assemblies sont des exécutions de vos Templates, déclenchées par un appel API
POSTvershttps://api2.transloadit.com/assembliesqui fait référence à votretemplate_id. Une Assembly contient des références à vos fichiers envoyés et aux résultats de traitement. En accédant au JSON de résultat de l’Assembly, vous pouvez récupérer en temps réel les métadonnées des fichiers et les URL des résultats pour les utiliser sur votre site web ou dans votre application.
Démarrage rapide
Nous vous recommandons de suivre notre guide Ma première application. Il présente les étapes essentielles pour démarrer avec l’API, avec des exemples et des explications pour vous aider à comprendre les concepts de base.
Authentification
Pour garantir une utilisation sécurisée de nos API, l’authentification est requise pour toutes vos requêtes. Nous créons automatiquement des clés d’API pour vous dès que vous créez votre premier Workspace après vous être connecté. Vous pouvez ainsi commencer immédiatement à créer et à tester des Templates. Toutefois, lorsque vous serez prêt à mettre votre application en production, consultez notre page sur l’authentification de l’API (English) pour savoir comment autoriser correctement vos requêtes avec des signatures.
Trois modes d’intégration
- Gestion des téléversements : si vos utilisateurs téléversent ou importent des fichiers depuis le navigateur, notre outil de téléversement de fichiers open source Uppy (English) est le meilleur choix pour votre intégration. Avec plus de 31 000 étoiles sur GitHub, c’est l’outil de téléversement de fichiers le plus populaire au monde !
- Smart CDN : pour la conversion et la diffusion basées sur des URL, notre Smart CDN est l’option d’intégration idéale.
- Traitement par lots : pour traiter de grands volumes de fichiers et développer des applications mobiles, nous proposons des SDK (English) pour les langages et plateformes populaires.
Vous avez trouvé un bug ou vous avez des commentaires ?
Nous cherchons toujours à améliorer notre plateforme et accordons de l’importance aux retours de nos utilisateurs. Si vous rencontrez un bug, avez des questions ou souhaitez partager des suggestions, n’hésitez pas à nous contacter.
Nous espérons que vous apprécierez Transloadit pour vos besoins de traitement de fichiers !