Keitaro icon

Keitaro

Работа с API Keitaro

Overview

This node interacts with the Keitaro API to perform various operations on different resources such as clicks, campaigns, conversions, postbacks, and statistics. Specifically, for the 'click' resource with the 'update' operation, it updates an existing click record by sending updated click data in JSON format to the Keitaro API. This node is useful for automating the management of click data within Keitaro, enabling users to programmatically update click information based on dynamic workflows.

Use Case Examples

  1. Updating click data to correct or add information after the click has been recorded.
  2. Automating click data updates as part of a larger campaign management workflow.
  3. Integrating Keitaro click updates with other marketing or analytics tools to maintain data consistency.

Properties

Name Meaning
ID Клика The unique identifier of the click to update. Required for update operations on the click resource.
Данные Клика The click data in JSON format to update the existing click record. Required for create and update operations on the click resource.

Output

JSON

  • request
    • url - The URL of the API request made to Keitaro.
    • method - The HTTP method used for the API request.
    • headers - Headers sent with the API request, with sensitive information like API keys masked.
  • resource - The resource type involved in the operation, e.g., 'click'.
  • operation - The operation performed, e.g., 'update'.
  • success - Indicates if the operation was successful (true for update).
  • data - The data returned from the Keitaro API after the update operation, typically the updated click object.

Dependencies

  • Requires an API key credential for Keitaro API access and the domain URL of the Keitaro instance.

Troubleshooting

  • Ensure the 'ID Клика' (click ID) is provided and valid for update operations; missing or invalid IDs will cause errors.
  • The 'Данные Клика' (click data) must be a valid JSON object with the fields to update; empty or malformed JSON will cause errors.
  • API key and domain must be correctly configured in credentials; missing or incorrect credentials will prevent API access.
  • For 'click' resource, the update operation sends a PUT request to the endpoint /admin_api/v1/clicks/{clickId} with the JSON body containing updated click data.
  • If the API response status code is not in the 200-299 range, an error is thrown with the status code and message from the API response.

Discussion