Keitaro icon

Keitaro

Работа с API Keitaro
Join our community

Actions72

Overview

This node interacts with the Keitaro API to manage postbacks, including updating existing postbacks. It supports operations such as creating, updating, retrieving, deleting, and testing postbacks. The update operation allows modifying postback details like name, URL, status, trigger conditions, HTTP method, and advanced settings such as authentication keys, currency, timeout, retry logic, campaign and country filters, HTTP headers, and additional parameters. This node is useful for automating postback management in affiliate marketing or conversion tracking workflows.

Use Case Examples

  1. Updating a postback to change its URL and status to active.
  2. Modifying postback triggers to fire only on sales instead of all conversions.
  3. Adding custom HTTP headers and parameters to a postback for enhanced security and tracking.

Properties

Name Meaning
ID Постбэка The unique identifier of the postback to update.
Название постбэка The name of the postback.
URL постбэка The URL to which the postback will be sent, supporting macros like {sub_id_1}, {status}, {revenue}.
Статус The status of the postback, either active or inactive.
Триггер Defines when the postback should be sent: on any conversion, only leads, or only sales.
HTTP метод The HTTP method used to send the postback, either GET or POST.
Статусы лидов Comma-separated list of statuses considered as leads.
Статусы продаж Comma-separated list of statuses considered as sales.
Отклоненные статусы Comma-separated list of statuses considered as rejected conversions.
Дополнительные настройки Flag to show advanced postback settings.
Ключ постбэка Authentication key for the postback to enhance security.
Валюта Default currency used for conversions.
Таймаут (сек) Timeout in seconds for sending the postback.
Количество повторных попыток Number of retry attempts if sending the postback fails.
Задержка между попытками (сек) Delay in seconds between retry attempts.
Кампании Comma-separated campaign IDs for which the postback will be sent; empty means all campaigns.
Страны Comma-separated country codes for which the postback will be sent; empty means all countries.
Настройка HTTP заголовков Flag to enable custom HTTP headers for the postback.
HTTP заголовки Custom HTTP headers to include in the postback request.
Параметры постбека Additional parameters to include in the postback request.
Статусы для отслеживания регистраций Comma-separated list of statuses considered as registrations (for Keitaro 10.3+).
Статусы для отслеживания депозитов Comma-separated list of statuses considered as deposits (for Keitaro 10.3+).

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 data masked.
  • resource - The resource type involved in the operation (e.g., postback).
  • 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 operation.
  • error - Error details if the operation failed.

Dependencies

  • Keitaro API with domain and API key credentials

Troubleshooting

  • Ensure the postback ID is provided for update operations; missing ID will cause errors.
  • Verify that the API key and domain are correctly set in credentials; missing or incorrect credentials will prevent API access.
  • Check that required fields like postback name and URL are not empty when updating.
  • If the API returns an error status, inspect the error message for details and correct the request accordingly.
  • For advanced settings, ensure that any custom headers or parameters are correctly formatted to avoid request failures.

Links

Discussion