Vytvořit tabulku

POST

tables

const table = await client.tables.create({
  schema_id: "schema_abc123",
  name: "Q1 Product Catalog",
  file_ids: ["file_xyz789"],
  webhook_url: "https://your-server.com/webhooks",
});

console.log(table.id);     // "tbl_..."
console.log(table.status); // "processing"

table = client.tables.create(
    schema_id="schema_abc123",
    name="Q1 Product Catalog",
    file_ids=["file_xyz789"],
    webhook_url="https://your-server.com/webhooks",
)

print(table["id"])      # "tbl_..."
print(table["status"])  # "processing"

curl -X POST "https://hub.banditshq.com/api/v1/tables" \
  -H "Authorization: Bearer lasso_..." \
  -H "Content-Type: application/json" \
  -d '{
    "schema_id": "schema_abc123",
    "name": "Q1 Product Catalog",
    "file_ids": ["file_xyz789"],
    "webhook_url": "https://your-server.com/webhooks"
  }'

{
  "id": "tbl_abc123",
  "name": "Q1 Product Catalog",
  "schema_id": "schema_xyz789",
  "status": "processing",
  "progress": 0,
  "total_rows": 0,
  "source_type": "files",
  "additional_context": null,
  "enhancement_context": null,
  "error_message": null,
  "files": [
    { "name": "catalog.pdf", "path": "company_123/file_xyz/catalog.pdf", "size": 1048576 }
  ],
  "created_at": "2025-03-10T14:30:00.000Z",
  "updated_at": "2025-03-10T14:30:00.000Z"
}

Tělo požadavku

string

povinné

ID schématu, které se použije pro extrakci.

string

povinné

Název tabulky.

string[]

Pole ID souborů (z Files API), ze kterých se mají extrahovat data. Zadejte přesně jedno z file_ids, file_urls nebo source_text.

string[]

Pole veřejně přístupných URL adres, ze kterých se mají extrahovat data.

string

Surový textový obsah, ze kterého se mají extrahovat data.

string

Dodatečný kontext pro řízení procesu extrakce.

string

Kontext pro AI obohacení extrahovaných dat.

string

URL pro příjem webhook notifikací po dokončení zpracování.

Odpověď

Vrací vytvořený objekt tabulky se stavem processing.

string

Jedinečný identifikátor tabulky.

string

Název tabulky.

string

Schéma použité pro extrakci.

string

Pro novou tabulku vždy processing.

integer

Průběh extrakce (0-100).

integer

Počet dosud extrahovaných řádků (zpočátku 0).

string

files nebo text.

string | null

Kontext extrakce.

string | null

Kontext obohacení.

string | null

Chybová zpráva, pokud zpracování selhalo.

array

Metadata nahraných souborů.

string

Časové razítko ISO 8601.

string

Časové razítko ISO 8601.

const table = await client.tables.create({
  schema_id: "schema_abc123",
  name: "Q1 Product Catalog",
  file_ids: ["file_xyz789"],
  webhook_url: "https://your-server.com/webhooks",
});

console.log(table.id);     // "tbl_..."
console.log(table.status); // "processing"

table = client.tables.create(
    schema_id="schema_abc123",
    name="Q1 Product Catalog",
    file_ids=["file_xyz789"],
    webhook_url="https://your-server.com/webhooks",
)

print(table["id"])      # "tbl_..."
print(table["status"])  # "processing"

curl -X POST "https://hub.banditshq.com/api/v1/tables" \
  -H "Authorization: Bearer lasso_..." \
  -H "Content-Type: application/json" \
  -d '{
    "schema_id": "schema_abc123",
    "name": "Q1 Product Catalog",
    "file_ids": ["file_xyz789"],
    "webhook_url": "https://your-server.com/webhooks"
  }'

{
  "id": "tbl_abc123",
  "name": "Q1 Product Catalog",
  "schema_id": "schema_xyz789",
  "status": "processing",
  "progress": 0,
  "total_rows": 0,
  "source_type": "files",
  "additional_context": null,
  "enhancement_context": null,
  "error_message": null,
  "files": [
    { "name": "catalog.pdf", "path": "company_123/file_xyz/catalog.pdf", "size": 1048576 }
  ],
  "created_at": "2025-03-10T14:30:00.000Z",
  "updated_at": "2025-03-10T14:30:00.000Z"
}

Čekání na dokončení

Tabulky se zpracovávají asynchronně. Použijte vestavěný polling helper SDK nebo nakonfigurujte webhook.

const completed = await client.tables.waitForCompletion(table.id, {
  intervalMs: 3000,
  timeoutMs: 300000,
});

console.log(completed.status);     // "completed"
console.log(completed.total_rows); // 42

completed = client.tables.wait_for_completion(
    table["id"],
    interval_s=3,
    timeout_s=300,
)

print(completed["status"])      # "completed"
print(completed["total_rows"])  # 42

const table = await client.tables.create({
  schema_id: "schema_abc123",
  name: "Q1 Product Catalog",
  file_ids: ["file_xyz789"],
  webhook_url: "https://your-server.com/webhooks",
});

console.log(table.id);     // "tbl_..."
console.log(table.status); // "processing"

table = client.tables.create(
    schema_id="schema_abc123",
    name="Q1 Product Catalog",
    file_ids=["file_xyz789"],
    webhook_url="https://your-server.com/webhooks",
)

print(table["id"])      # "tbl_..."
print(table["status"])  # "processing"

curl -X POST "https://hub.banditshq.com/api/v1/tables" \
  -H "Authorization: Bearer lasso_..." \
  -H "Content-Type: application/json" \
  -d '{
    "schema_id": "schema_abc123",
    "name": "Q1 Product Catalog",
    "file_ids": ["file_xyz789"],
    "webhook_url": "https://your-server.com/webhooks"
  }'

{
  "id": "tbl_abc123",
  "name": "Q1 Product Catalog",
  "schema_id": "schema_xyz789",
  "status": "processing",
  "progress": 0,
  "total_rows": 0,
  "source_type": "files",
  "additional_context": null,
  "enhancement_context": null,
  "error_message": null,
  "files": [
    { "name": "catalog.pdf", "path": "company_123/file_xyz/catalog.pdf", "size": 1048576 }
  ],
  "created_at": "2025-03-10T14:30:00.000Z",
  "updated_at": "2025-03-10T14:30:00.000Z"
}

Přehled

Vyhledávání

Obohacení dat

Tabulky

Řádky

Obohacení

Schémata

Atributy

Soubory

Slovník

Kredity

Katalog

Webhooky katalogu

Vytvořit tabulku

Tělo požadavku

Odpověď

Čekání na dokončení

​Tělo požadavku

​Odpověď

​Čekání na dokončení

Tělo požadavku

Odpověď

Čekání na dokončení