Ir para o conteúdo

Gerir CSV

Este guia de API fornece uma visão geral de como um csv é usado para gerar uma solicitação em massa.

Para iniciar uma solicitação em massa, você precisará fornecer um arquivo csv contendo todos os nomes de variáveis de modelo como cabeçalhos de colunas csv: Texto de modelo de exemplo: Olá, meu nome é {{First Name}} {{Last Name}} e trabalho na {{Company}} há dez anos.

First Name Last Name Company
Johan Smith Immersivefox
Jack Parker Red Chillies

Esses campos serão usados como macros no processamento em massa para personalizar e customizar o conteúdo gerado. 🌟

Início rápido

Vamos nos aprofundar e explorar como carregar e listar seus arquivos csv, para que você possa gerar vídeos em massa com eficiência usando-os mais tarde.

Carregando CSV

Para carregar um novo arquivo CSV, use este ponto de extremidade da API. Basta passar o arquivo CSV nos dados da solicitação e enviar os dados como multipart/form-data. Em resposta, você receberá um 'id' que pode ser usado como 'csv_id' para criar solicitações em massa e modelos. Para referência, aqui está um exemplo de arquivo 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",
}

Listando CSV

Para recuperar arquivos CSV enviados anteriormente, use este endpoint de API. A resposta incluirá uma lista de todos os arquivos CSV, e você pode usar o 'id' do CSV desejado como 'csv_id' para criar solicitações em massa e modelos.

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",
    }
]