Avito icon

Avito

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

Actions29

Overview

This node integrates with the Avito API to facilitate various business operations related to Avito listings. Specifically, for the resource Автозагрузка (Autoload) and operation 🔗 Конвертация: Файл ID → Avito ID (Conversion: File ID → Avito ID), it provides a way to map listing IDs from an uploaded XML file to their corresponding Avito listing IDs. This is useful for quickly checking which listings from a batch file are published on Avito and retrieving their official Avito IDs.

Practical scenarios include:

  • Synchronizing external listing data with Avito's platform by matching internal file IDs to Avito IDs.
  • Verifying publication status of multiple listings in bulk.
  • Automating updates or management tasks based on the presence or absence of listings on Avito.

Properties

Name Meaning
ID Объявлений Из Файла Comma-separated or pipe-separated list of listing IDs extracted from the XML autoload file. These IDs correspond to the <ID> parameter in the XML and serve as input for mapping to Avito IDs.
🔗 Получение Avito ID по ID из файла

📋 Назначение:
• Связь между ID в файле и ID на Авито
• Поиск опубликованных объявлений
• Прямое сопоставление объявлений

🔍 Входные данные:
• ID из параметра <ID> в XML файле
• Например: item1, item2, item3
• Разделители: запятая (,) или символ (		 )

📊 Результат:
• Пары: ID из файла → Avito ID
• Null если объявление не опубликовано
• Быстрый поиск статуса публикации

Output

The node outputs JSON objects where each entry corresponds to one input item. The JSON contains pairs mapping the original file listing IDs to their respective Avito IDs. If a listing is not published on Avito, its mapped value will be null. This allows users to quickly identify which listings are active on Avito and retrieve their official IDs.

No binary data output is indicated for this operation.

Example output structure (conceptual):

{
  "item1": "123456789",
  "item2": null,
  "item3": "987654321"
}

Dependencies

  • Requires an API authentication token credential for Avito (OAuth2 or similar).
  • The node depends on internal routing utilities (RouterUtils) to handle the specific operation logic.
  • No additional external services beyond Avito API are indicated.
  • Proper configuration of the Avito API credentials within n8n is necessary.

Troubleshooting

  • Common issues:

    • Incorrect formatting of the input ID string (e.g., missing commas or pipes as separators) may cause failures or incorrect mappings.
    • Providing IDs that do not exist or are unpublished on Avito will result in null values.
    • Missing or invalid API credentials will cause authentication errors.
    • Unknown resource or operation parameters will throw errors indicating unsupported actions.

  • Error messages:

    • "Unknown resource: ..." — indicates the resource parameter is invalid or unsupported.
    • Authentication errors typically indicate misconfigured or missing API credentials.
    • Parsing errors may occur if the input string is malformed.

  • Resolutions:

    • Ensure the input string uses commas or pipes correctly as separators.
    • Verify API credentials are set up and valid.
    • Confirm the resource is set to "autoload" and operation to "getAvitoIdsByAdIds".
    • Use the node’s "Continue On Fail" option to handle partial failures gracefully.

Links and References

This summary is based solely on static analysis of the provided source code and property definitions without runtime execution.

Discussion