Avito API Skill
Этот навык предоставляет знания для взаимодействия с API Авито.
Базовые URL
- - API: INLINECODE0
- OAuth (для получения кода): INLINECODE1
- Документация: INLINECODE2
Авторизация (OAuth 2.0)
Авито поддерживает два типа авторизации:
1. Персональная авторизация (Client Credentials)
Используется для работы от своего имени (личный кабинет/бизнес-аккаунт).
- - Endpoint: INLINECODE3
- Параметры (URL-encoded):
-
grant_type:
client_credentials
-
client_id: Ваш Client ID (из личного кабинета)
-
client_secret: Ваш Client Secret
- - Срок действия: 24 часа.
Пример запроса:
CODEBLOCK0
2. Авторизация для приложений (Authorization Code)
Для работы с данными других пользователей.
- - Шаг 1: Редирект пользователя на
https://avito.ru/oauth?response_type=code&client_id=<CLIENT_ID>&scope=<SCOPES>&state=<STATE>. - Шаг 2: Обмен
code на токены через POST /token с grant_type=authorization_code.
Мессенджер API (Messenger)
Методы для работы с чатами. Позволяют интегрировать Авито в CRM.
Ключевые эндпоинты:
- - Список чатов: INLINECODE12
- Сообщения в чате: INLINECODE13
- Отправить сообщение: INLINECODE14
- Тело:
{"message": {"text": "текст"}, "type": "text"}
- - Отправить изображение: INLINECODE16
- Загрузить изображение:
POST /messenger/v1/accounts/{user_id}/uploadImages (multipart/form-data) - Прочитать чат: INLINECODE18
- Голосовые сообщения: INLINECODE19
Вебхуки (Webhooks):
- - Подписка: INLINECODE20
- Отписка: INLINECODE21
Объявления и Статистика (Items & Stats)
- - Получение информации об объявлениях: INLINECODE22
- Статистика объявлений: INLINECODE23
- Применение доп. услуг (VAS): INLINECODE24
Доступные Scopes:
- -
messenger:read, INLINECODE26 - INLINECODE27 , INLINECODE28
- INLINECODE29
- INLINECODE30 ,
user_balance:read, INLINECODE32 - INLINECODE33
- INLINECODE34 ,
job:vacancy, INLINECODE36
Важные примечания:
- 1. Для работы API требуется один из платных тарифов («Базовый», «Расширенный» или «Максимальный»).
- Все запросы должны содержать заголовок
Authorization: Bearer <ACCESS_TOKEN>. - Сообщения от чат-ботов имеют
type: system и flow_id.
Avito API 技能
此技能提供与 Avito API 交互的知识。
基础 URL
- - API: https://api.avito.ru
- OAuth（用于获取授权码）: https://avito.ru/oauth
- 文档: https://developers.avito.ru/
授权（OAuth 2.0）
Avito 支持两种授权类型：
1. 个人授权（客户端凭证）
用于以自身身份（个人账户/企业账户）进行操作。
- - 端点: POST /token
- 参数（URL 编码）:
- grant
type: clientcredentials
- client_id: 您的客户端 ID（来自个人账户）
- client_secret: 您的客户端密钥
请求示例：
bash
curl -X POST https://api.avito.ru/token \
-H Content-Type: application/x-www-form-urlencoded \
--data-urlencode granttype=clientcredentials \
--data-urlencode clientid=ID> \
--data-urlencode clientsecret=SECRET>
2. 应用授权（授权码）
用于处理其他用户的数据。
- - 步骤 1：将用户重定向至 https://avito.ru/oauth?responsetype=code&clientid=ID>&scope=&state=。
- 步骤 2：通过 POST /token 并设置 granttype=authorization_code，将 code 兑换为令牌。
消息 API（Messenger）
用于处理聊天的方法。支持将 Avito 集成到 CRM 中。
关键端点：
- - 聊天列表: GET /messenger/v2/accounts/{userid}/chats
- 聊天消息: GET /messenger/v3/accounts/{userid}/chats/{chatid}/messages
- 发送消息: POST /messenger/v1/accounts/{userid}/chats/{chat_id}/messages
- 请求体：{message: {text: 文本}, type: text}
- - 发送图片: POST /messenger/v1/accounts/{userid}/chats/{chatid}/messages/image
- 上传图片: POST /messenger/v1/accounts/{userid}/uploadImages（multipart/form-data）
- 标记已读: POST /messenger/v1/accounts/{userid}/chats/{chatid}/read
- 语音消息: GET /messenger/v1/accounts/{userid}/getVoiceFiles?voice_ids={ids}
Webhook：
- - 订阅: POST /messenger/v1/webhook
- 取消订阅: POST /messenger/v1/webhook/unsubscribe
商品与统计（Items & Stats）
- - 获取商品信息: GET /core/v1/items
- 商品统计: POST /stats/v1/accounts/{userid}/items
- 应用增值服务（VAS）: POST /vas/v1/accounts/{userid}/vas
可用权限范围：
- - messenger:read、messenger:write
- items:info、items:applyvas
- stats:read
- user:read、userbalance:read、user_operations:read
- autoload:reports
- job:cv、job:vacancy、job:write
重要说明：
- 1. 使用 API 需要付费套餐之一（“基础版”、“高级版”或“最高版”）。
- 所有请求必须包含 Authorization: Bearer TOKEN> 标头。
- 来自聊天机器人的消息具有 type: system 和 flowid。
