Avito icon

Avito

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

Actions29

Overview

This node integrates with the Avito API to work with ratings and reviews data. Specifically, the "Информация О Рейтинге" (Rating Information) operation retrieves detailed information about a rating on Avito. This includes the overall score, counts of active reviews, and how many reviews influence the rating.

Use cases for this node include:

  • Fetching current rating statistics for a product or service listed on Avito.
  • Monitoring customer feedback trends by analyzing review counts and scores.
  • Integrating rating data into dashboards or reports for business insights.

For example, a business owner could use this node to automatically pull their Avito rating info daily and trigger alerts if the score drops below a threshold.

Properties

Name Meaning
📋 Информация о рейтингах Avito

🔐 Требуемые разрешения:
• ratings:read - для получения информации и списка отзывов
• ratings:write - для создания и удаления ответов

📊 Структура рейтинга:
• score - оценка рейтинга (float)
• reviewsCount - общее количество активных отзывов
• reviewsWithScoreCount - количество отзывов, влияющих на рейтинг

💡 Особенности:
• Рейтинг может быть отключен (isEnabled: false)
• Не все отзывы влияют на формирование оценки
• Ответы на отзывы проходят модерацию		 This is an informational notice describing the permissions required and the structure of the rating data returned by the API. It explains that the node requires read permission to fetch rating info and write permission to manage responses to reviews. The rating structure includes a floating-point score, total active reviews count, and count of reviews affecting the score. It also notes that ratings can be disabled and not all reviews impact the rating calculation.

Output

The node outputs JSON data containing the rating information retrieved from Avito. The typical fields in the output JSON are:

  • score (float): The numeric rating score.
  • reviewsCount (integer): Total number of active reviews.
  • reviewsWithScoreCount (integer): Number of reviews that influence the rating score.
  • isEnabled (boolean): Indicates whether the rating is currently enabled or disabled.

This structured output allows downstream nodes or workflows to process rating metrics, display them, or trigger actions based on rating status.

The node does not output binary data.

Dependencies

  • Requires an API authentication token configured via OAuth2 credentials for Avito.
  • Permissions needed on the API key include at least ratings:read to fetch rating information.
  • The node depends on the Avito API being accessible and the user having appropriate rights to query rating data.

Troubleshooting

  • Common issues:

    • Insufficient permissions error if the API token lacks ratings:read.
    • Network or connectivity errors if Avito API is unreachable.
    • Errors if the specified resource or operation parameters are incorrect or missing.

  • Error messages:

    • "Unknown resource": Occurs if the resource parameter is not set to "ratings".
    • API errors related to authorization typically indicate missing or invalid API credentials.
    • If the rating is disabled (isEnabled: false), the returned data may reflect no active score or reviews.

  • Resolutions:

    • Ensure the OAuth2 credential has the necessary scopes/permissions.
    • Verify network connectivity and Avito API status.
    • Double-check input parameters for correctness.

Links and References

Discussion