Gestion du fichier CSV
Ce guide API fournit un aperçu de la façon dont un fichier csv est utilisé pour générer une demande en masse.
Pour lancer une demande en masse, vous devrez fournir un fichier csv contenant tous les noms de variables de modèle comme en-têtes de colonnes csv :
Exemple de texte de modèle : Bonjour, je m'appelle {{Prénom}} {{Nom}} et je travaille chez {{Entreprise}} depuis dix ans.
Prénom | Nom | Entreprise |
---|---|---|
Johan | Smith | Immersivefox |
Jack | Parker | Red Chillies |
Ces champs seront utilisés comme macros dans le traitement en masse pour personnaliser et personnaliser le contenu généré. 🌟
Démarrage rapide
Plongeons-nous dans le vif du sujet et explorons comment télécharger et répertorier vos fichiers csv, afin que vous puissiez générer efficacement des vidéos en masse en les utilisant plus tard.
Téléchargement CSV
Pour télécharger un nouveau fichier CSV, utilisez ce point de terminaison d'API. Transmettez simplement le fichier CSV dans les données de la demande et envoyez les données sous la forme multipart/form-data
. En réponse, vous recevrez un identifiant ('id') que vous pourrez utiliser comme identifiant ('csv_id') pour créer des requêtes groupées (video_request.md) et des modèles (template.md). À titre d'exemple, voici un fichier CSV (**https://storage.googleapis.com/immersive-fox-backend-bucket/bulk_csv_file/test2_EzNtkVJ.csv)).
curl --request POST \
--url 'https://api.immersive-fox.com/v1/bulk_requests/upload_csv/' \
--header 'X-Api-Key: <your-api-key>' \
--header 'Content-Type: multipart/form-data' \
-F 'csv_file=@my_contacts.csv'
{
"id": 172,
"user": 31,
"file_name": "my_contacts.csv",
}
Liste des fichiers CSV :
pour récupérer les fichiers CSV précédemment téléchargés, utilisez ce point de terminaison d'API. La réponse inclura la liste de tous les fichiers CSV, et vous pourrez utiliser l'identifiant du fichier CSV souhaité comme identifiant CSV pour créer des requêtes groupées (video_request.md) et des modèles (template.md).
curl --request GET \
--url 'https://api.immersive-fox.com/v1/bulk_requests/csvs/' \
--header 'X-Api-Key: <your-api-key>' \
--header 'Content-Type: application/json'
[
{
"id": 120,
"user": 31,
"file_name": "my_contacts.csv",
},
{
"id": 159,
"user": 31,
"file_name": "my_employees.csv",
}
]