Avito icon

Avito

Взаимодействие с API Авито для бизнеса

Actions29

Overview

This node integrates with the Avito API, a popular classifieds platform, to perform various operations on different resources such as listings (Объявление), promotions, ratings, and autoload settings. Specifically, for the resource "Объявление" (Listing) and operation "Применить Услугу" (Apply Service), the node allows users to apply additional paid services or enhancements to an existing listing by specifying service identifiers.

Common scenarios where this node is beneficial include:

  • Enhancing visibility of a classified ad by applying promotional services like highlighting or XL-format.
  • Automating the management of ads by programmatically adding value-added services based on business logic.
  • Integrating Avito listings management into broader workflows, e.g., syncing inventory or marketing campaigns.

Practical example:

  • A user wants to highlight a car sale ad and add an XL-format service to make it stand out. They provide the listing ID and specify the desired services via slugs, and the node applies these services through the Avito API.

Properties

Name Meaning
ID Объявления Unique numeric ID of the listing to which the services will be applied.
Услуги (Slug) Comma-separated list of service slugs to apply (e.g., xl, highlight, x2_7, x5_7, x10_7). These represent different paid services available on Avito. Users can obtain valid slugs from the "Стоимость Услуг" (Service Cost) operation.
ID Значков Comma-separated list of up to 3 sticker IDs used in conjunction with the XL-listing service. Sticker IDs can also be retrieved via the "Стоимость Услуг" operation.

Output

The node outputs JSON data representing the result of the "apply service" operation on the specified listing. This typically includes confirmation details about the applied services or any relevant response from the Avito API.

If the operation fails, the output JSON contains an error field with the error message.

No binary data output is indicated in the source code.

Dependencies

  • Requires an API key credential for authenticating with the Avito OAuth2 API.
  • The node depends on internal routing utilities (RouterUtils) to handle specific resource-operation calls.
  • No other external dependencies are explicitly required.

Troubleshooting

  • Common issues:

    • Providing invalid or non-existent listing IDs will cause errors.
    • Using incorrect or unsupported service slugs or sticker IDs may lead to API rejections.
    • Exceeding the maximum allowed number of stickers (more than 3) will likely cause failure.
    • Missing or invalid API credentials will prevent successful API calls.

  • Error messages:

    • "Unknown resource: <resource>": Indicates that the specified resource is not supported by the node.
    • API errors returned from Avito will be passed through in the error field if "Continue On Fail" is enabled.

  • Resolutions:

    • Verify listing IDs exist and belong to the authenticated user.
    • Retrieve valid service slugs and sticker IDs using the "Стоимость Услуг" operation before applying them.
    • Ensure API credentials are correctly configured and have necessary permissions.
    • Use the "Continue On Fail" option to handle partial failures gracefully in batch executions.

Links and References

  • Avito API Documentation (official site, mostly in Russian)
  • Operation "Стоимость Услуг" (Service Cost) within this node to retrieve valid service slugs and sticker IDs.

Discussion