Kobana icon

Kobana

Interact with Kobana API - Quick access to common operations
Join our community

Actions215

Overview

This node integrates with the Kobana API to manage PIX transfer batches, specifically supporting the "Get Many" operation for the resource "Transfer > PIX Batches". It allows users to retrieve multiple PIX transfer batch records from their Kobana account.

Common scenarios where this node is beneficial include:

  • Retrieving a list of PIX transfer batches for reconciliation or reporting.
  • Fetching batches filtered by specific query parameters such as date ranges or status.
  • Automating workflows that require processing or analyzing multiple PIX transfer batches at once.

For example, a user might want to fetch all PIX transfer batches created in the last month to generate a financial report or to trigger downstream processes based on batch statuses.

Properties

Name Meaning
Return All Whether to return all results or only up to a given limit.
Limit Maximum number of results to return (only used if Return All is false). Range: 1 to 100.
Additional Fields JSON object with additional fields for the request (optional extra parameters).
Query Parameters JSON object with query parameters to filter or modify the request (e.g., filters, sorting).

Output

The node outputs an array of JSON objects representing PIX transfer batches retrieved from the Kobana API. Each object corresponds to one PIX transfer batch and contains its details as returned by the API.

If the API supports binary data for this resource (not indicated here), it would be summarized accordingly, but for this operation, the output is purely JSON data describing the batches.

Dependencies

  • Requires an API key credential for Kobana API authentication.
  • The node dynamically selects the API base URL depending on the environment (production or sandbox).
  • No other external dependencies are required.

Troubleshooting

  • Common Issues:

    • Incorrect or missing API credentials will cause authentication failures.
    • Providing invalid JSON in "Additional Fields" or "Query Parameters" may cause request errors.
    • Exceeding API rate limits or requesting too many records without pagination can lead to errors or timeouts.

  • Error Messages:

    • Authentication errors typically indicate invalid or missing API keys; verify credentials.
    • JSON parsing errors suggest malformed JSON input in properties; ensure valid JSON syntax.
    • API response errors may include messages about invalid parameters; check query parameters and limits.

To resolve these issues:

  • Double-check API credentials and permissions.
  • Validate JSON inputs using online tools before entering them.
  • Use the "Return All" option carefully to avoid large data requests; prefer setting reasonable limits.

Links and References

Discussion