Descrizione
Connettore enterprise per Airtable — la piattaforma low-code database+spreadsheet ibrida nata 2012 a San Francisco con 300k+ paying customer di startup, agency, marketing team, education che la usano come rapid prototyping di applicazioni database-driven con UI native (grid, kanban, calendar, gallery view) senza dover scrivere codice né configurare uno schema PostgreSQL. Cinque operazioni atomiche CRUD via REST API v0 ufficiale: listRecords (read con filterByFormula in dialetto Airtable formula syntax stile spreadsheet "AND({Status}='Open',{Priority}>1)", sort multi-criteria, fields whitelist per ridurre payload, pagination cursor-based), getRecord (fetch puntuale by record_id rec0123456789ABC), createRecord (insert con typecast option che permette ad Airtable di coercere "Closed" string al select_field option corretto evitando errori), updateRecord (patch atomic dei field specificati, gli altri restano invariati — diverso da PUT che resetterebbe i field non-specificati), deleteRecord. Auto-pagination per listRecords: l'API Airtable cap a 100 record/page e usa offset opaque cursor — il nodo automaticamente itera fino a recuperare TUTTI i record corrispondenti al filtro (con safety cap default 10000 totali per evitare runaway su table giganti), unificando in un singolo array di output pronto per loop downstream. Auth via Personal Access Token (formato patxxxxxxxx.xxxxxxxx generato da admin in Settings → Developer Hub → Personal Access Tokens con scope schema.bases:read + data.records:read|write granular per base) stored nel vault integration FlowForge. Multi-base supportato (un tenant FlowForge che gestisce 3 base Airtable diverse per agency che serve N cliente). Rate limit Airtable: 5 req/sec per base in Plus/Pro plan, 50 req/sec in Enterprise — il nodo gestisce 429 con Retry-After header + backoff exponential automatico. Header X-Airtable-Application-ID tracked per debug attribuzione delle quote. Output: { records: [{ id, fields: { [name]: value }, createdTime }], record?, deleted?, recordsCount, pagesScanned }. Use case: lead capture da form web (Typeform/trigger_form) → createRecord nella base "CRM Leads" con campos Name+Email+Company+Source+CreatedAt, opzionale typecast=true se Source viene da dropdown opzioni pre-definite; sync inventory bidirezionale e-commerce↔Airtable per piccoli merchant che usano Airtable come stockmaster invece di un ERP completo (updateRecord di stock_qty quando arriva ordine Stripe); progetti Kanban automatico (move card by status — update record's Status field da "Todo" a "In Progress" quando un workflow event triggers, Airtable native auto-aggiorna la Kanban view); survey responses aggregate per analytics market research con listRecords + logic_aggregate (count per region, avg satisfaction score); media library con metadata + attachment field per asset management leggero (upload foto prodotto via API attachment + metadata strutturata).
