Larkbase icon

Larkbase

Truy vấn dữ liệu từ Larkbase API - Larksuite Base
Join our community

Actions3

Overview

This node performs operations on records within a Larkbase (Lark Suite Base) application, specifically supporting creating multiple records, updating multiple records, and searching records in a table. It is useful for automating data management tasks such as bulk record creation, batch updates, and complex searches with filtering, sorting, and pagination. For example, it can be used to search records with specific field values, retrieve all matching records across multiple pages, or update multiple records in one operation.

Use Case Examples

  1. Search records in a table with specific filter conditions and sorting.
  2. Create multiple records in a Larkbase table from JSON input.
  3. Update multiple existing records in a table with new field values.

Properties

Name Meaning
Base ID / App Token Identifier for the Larkbase application or base, required for authentication and specifying the target app.
Access Token Authentication token used to authorize API requests to Larkbase.
Table ID Identifier of the table within the Larkbase app where records are created, updated, or searched.
Search Parameters JSON object specifying search criteria including filters, fields to return, view ID, sorting, and other options for searching records.
Page Size Number of records to return per page in search results, up to a maximum of 500.
Tự động lấy tất cả kết quả Boolean flag to automatically fetch all pages of search results instead of just the first page.
Số lượng kết quả tối đa Maximum number of search results to return when auto-fetching all pages.
Debug Level Level of debug information returned, ranging from basic to detailed including request/response data.

Output

JSON

  • records - Array of record objects returned from create or update operations.
  • status - Status of the operation, e.g., 'success'.
  • recordCount - Number of records processed or returned.
  • skippedRecords - Number of records skipped during update (if applicable).
  • items - Array of records returned from a search operation.
  • total - Total number of records matching the search criteria.
  • has_more - Boolean indicating if more pages of results are available.
  • page_token - Token for fetching the next page of results.
  • debug - Debug information based on the selected debug level.

Dependencies

  • Requires API authentication tokens: Base ID / App Token and Access Token for Larkbase API.

Troubleshooting

  • Error if Base ID / App Token or Table ID is missing: Ensure these required parameters are provided.
  • Error if Access Token is missing or invalid: Provide a valid access token starting with 't-' or 'u-'.
  • JSON parsing errors for records or search parameters: Verify JSON syntax and structure before input.
  • Warnings if tokens do not follow expected format: Check token prefixes and correctness.
  • API errors related to invalid requests or permissions: Confirm API credentials and permissions are correct.

Links

Discussion