CSV の管理

この API ガイドでは、csv を使用して一括リクエストを生成する方法の概要を説明します。

---

一括リクエストを開始するには、csv 列ヘッダーとしてすべてのテンプレート変数名を含む csv ファイルを提供する必要があります。 サンプル テンプレート テキスト: こんにちは。私の名前は {{First Name}} {{Last Name}} で、過去 10 年間 {{Company}} で働いています。

名	姓	会社
Johan	Smith	Immersivefox
Jack	Parker	Red Chillies

これらのフィールドは、生成されたコンテンツをパーソナライズおよびカスタマイズするための一括処理のマクロとして使用されます。 🌟

クイック スタート

では、csv ファイルをアップロードして一覧表示する方法について詳しく見ていきましょう。これにより、後でそれらを使用して一括ビデオを効率的に生成できるようになります。

CSV のアップロード

新しい CSV ファイルをアップロードするには、この API エンドポイントを使用します。リクエスト データで CSV ファイルを渡し、データを multipart/form-data として送信するだけです。応答として、'id' が返されます。これを 'csv_id' として使用して、一括リクエスト と テンプレート を作成できます。参考までに、サンプルの 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'

=== 「レスポンス」

```javascript
{
    "id": 172,
    "user": 31,
    "file_name": "my_contacts.csv",
}
```

CSV の一覧表示

以前にアップロードした CSV ファイルを取得するには、この API エンドポイントを使用します。応答にはすべての CSV ファイルの一覧が含まれ、目的の CSV の 'id' を 'csv_id' として使用して、一括リクエスト と テンプレート を作成できます。

リクエスト

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'

=== 「レスポンス」

```javascript
[
    {
        "id": 120,
        "user": 31,
        "file_name": "my_contacts.csv",
    },
    {
        "id": 159,
        "user": 31,
        "file_name": "my_employees.csv",
    }
]
```