Skip to main content
POST
cURL

Poznámky k použití

  • Pro funkční extrakci zadejte právě jeden zdroj: neprázdné pole file_ids nebo neprázdné source_text.
  • file_urls zůstává přijímaným kompatibilním polem, ale extrakční worker URL nestáhne. Požadavek se může zařadit do fronty bez platného výsledku. Vzdálený soubor nejprve stáhněte a nahrajte přes POST /files.
  • Duplicitní názvy zdrojových souborů jsou odmítnuty. Celkový limit velikosti extrakce je 512 MB.
  • Vybrané Product Schema se při vytvoření zkopíruje do tabulky. Pozdější změny opakovaně použitelného Product Schema nepřepíšou snapshot tabulky.
  • Úspěšný požadavek vrátí 201 se stavem queued_for_processing. Dotazujte GET /tables/{table_id}, dokud stav nebude completed, error nebo cancelled.
  • Nastavte webhook_url, pokud chcete konečný výsledek extrakce získat bez dotazování.
Limit pro nahrání a limit pro extrakci nejsou stejné. Před odesláním velkých dokumentů si přečtěte Soubory a limity extrakce.

Příklady

Example response

Autorizace

Authorization
string
header
povinné

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Tělo

application/json
schema_id
string
povinné

Schema defining the column structure

name
string
povinné

Table name

file_ids
string<uuid>[]

IDs of previously uploaded files

Minimum array length: 1
file_urls
string<uri>[]
zastaralé

Legacy compatibility field. The handler accepts and queues these URLs, but the current extraction worker does not download them, so the extraction cannot complete correctly. Download each file and use file_ids instead.

source_text
string

Raw text containing product data

Minimum string length: 1
additional_context
string

Extra instructions for the AI extraction

enhancement_context
string

Default context for all AI enhancements on this table

webhook_url
string<uri>

URL to notify when extraction completes or fails

Odpověď

Created table, extraction started

id
string
povinné
name
string
povinné
schema_id
string
povinné
status
enum<string>
povinné

Raw extraction job status returned by the API.

Dostupné možnosti:
queued,
queued_for_processing,
processing,
processing_by_worker,
completed,
error,
cancelled
total_rows
integer
povinné
created_at
string<date-time>
povinné
updated_at
string<date-time>
povinné
progress
integer
Požadovaný rozsah: 0 <= x <= 100
source_type
enum<string>
Dostupné možnosti:
files,
text
additional_context
string | null
enhancement_context
string | null
error_message
string | null
files
object[]
locked
boolean
locked_at
string<date-time> | null
locked_by
string<uuid> | null
skipped_source_updates
integer
last_skipped_source_update_at
string<date-time> | null