POST /csv

Acquisisci righe CSV (o righe di fogli di calcolo JSON) come documenti bozza, un documento per riga.

Auth: Bearer JWT (WorkOS).

Parametri di query

Corpo della richiesta

Sono accettati due tipi di contenuto, instradati dall'intestazione Content-Type.

multipart/form-data — campi:

• schema_name (testo, obbligatorio)
• file (byte CSV grezzi, obbligatorio). La prima riga contiene le intestazioni; ogni cella diventa un valore stringa JSON ripulito dagli spazi.

application/json (max 10 MiB):

{
  "schema_name": "post",
  "spreadsheet_data": [ { "title": "Row 1" }, { "title": "Row 2" } ]
}

• schema_name (stringa, obbligatorio)
• spreadsheet_data (array di oggetti, obbligatorio)

Risposta

{ "inserted": 2 }

Restituisce 201 Created. Ogni riga diventa un documento bozza; il titolo del documento è il primo valore di stringa della riga.

Esempio — JSON

curl -X POST '{CMS_API_URL}/csv?website_id=<uuid>' \
  -H 'Authorization: Bearer <workos-jwt>' \
  -H 'Content-Type: application/json' \
  -d '{"schema_name":"post","spreadsheet_data":[{"title":"Row 1"}]}'

Esempio — CSV multipart

curl -X POST '{CMS_API_URL}/csv?website_id=<uuid>' \
  -H 'Authorization: Bearer <workos-jwt>' \
  -F 'schema_name=post' \
  -F 'file=@data.csv'

Errori

• 400 — errori di parsing, schema_name/file mancanti, spreadsheet_data non array, righe non oggetto o CSV vuoto
• 401 — JWT mancante o non valido
• 500 — errore di inserimento