Перейти к содержанию

GetProduct#

Test Postman Apidog

Бета-версия

Функциональность находится в режиме бета-версии. Функции могут быть изменены, а также могут работать нестабильно.

Метод предназначен для получения информации о конкретном продукте каталога по его идентификатору.

Особенности работы метода

  • Метод работает без авторизации инстанса через публичный GraphQL WhatsApp*.
  • Если инстанс авторизован как бизнес-аккаунт – чтение происходит через Facebook GraphQL (видны товары на модерации или скрытые).
  • Если не авторизован – видны только одобренные товары.

Запрос#

Для получения продукта требуется выполнить запрос по адресу:

POST 
{{baseUrl}}/waInstance{{idInstance}}/getProduct/{{apiTokenInstance}}

Для получения параметров запроса idInstance и apiTokenInstance обратитесь к разделу Перед началом работы.

Параметры запроса#

Параметр Тип Обязательный Описание
chatId string Да Идентификатор чата продавца в формате 79991234567@c.us
productId string Да Уникальный идентификатор продукта в WhatsApp*

Пример тела запроса#

{
  "chatId": "79636191159@c.us",
  "productId": "26437451389197252"
}

Ответ#

Поля ответа#

Поле Тип Описание
id string Уникальный идентификатор продукта
name string Название товара
description string Описание товара
price string Цена (в минимальных денежных единицах, например 95000 = 950.00 RUB)
currency string Код валюты (например, RUB)
retailer_id string/null Идентификатор товара у продавца
is_hidden boolean/null Скрыт ли товар
is_sanctioned boolean Находится ли товар под санкциями
product_availability string Доступность товара (IN_STOCK, OUT_OF_STOCK и др.)
max_available integer Максимальное доступное количество
url string/null Ссылка на страницу товара
shimmed_url string/null Обработанный URL
status_info object Информация о статусе модерации (поле status: APPROVED, PENDING, REJECTED)
sale_price string/null Цена со скидкой (если есть)
media object Медиафайлы (массивы images и videos)
belongs_to string/null Владелец продукта
compliance_category string/null Категория соответствия
compliance_info object/null Информация о соответствии (включает country_code_origin, importer_name, importer_address)
variant_info object/null Информация о вариантах товара

Пример тела ответа#

{
  "id": "26437451389197252",
  "retailer_id": null,
  "is_hidden": null,
  "is_sanctioned": false,
  "product_availability": "IN_STOCK",
  "max_available": 99,
  "name": "Handmade Ceramic Mug - Large+",
  "description": "Hand-painted ceramic mug, 450ml. Dishwasher safe. New larger size.",
  "url": null,
  "shimmed_url": null,
  "currency": "RUB",
  "price": "95000",
  "status_info": {
    "can_appeal": null,
    "status": "APPROVED"
  },
  "sale_price": null,
  "media": {
    "images": [
      {
        "id": "26756491040611445",
        "original_image_url": "https://mmg.whatsapp.net/...",
        "request_image_url": "https://mmg.whatsapp.net/..."
      }
    ],
    "videos": []
  },
  "belongs_to": null,
  "compliance_category": null,
  "compliance_info": {
    "country_code_origin": "RU",
    "importer_name": "",
    "importer_address": null
  },
  "variant_info": null
}

Ошибки GetProduct#

Перечень общих для всех методов ошибок смотрите в разделе Стандартные ошибки

Примеры кода#

import requests

url = "{{apiUrl}}/waInstance{{idInstance}}/getProduct/{{apiTokenInstance}}"

payload = {
    "chatId": "79636191159@c.us",
    "productId": "26437451389197252"
}
headers = {
    'Content-Type': 'application/json'
}

response = requests.post(url, json=payload, headers=headers)

print(response.text.encode('utf8'))

curl --location '{{apiUrl}}/waInstance{{idInstance}}/getProduct/{{apiTokenInstance}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"chatId": "79636191159@c.us",
"productId": "26437451389197252"
}'

Внимание

  • Организация Meta, а также её продукты Instagram и Facebook, на которые мы ссылаемся в этой статье, признаны экстремистскими на территории РФ.

  • WhatsApp* принадлежит компании Meta Platforms Inc., деятельность которой признана экстремистской и запрещена на территории Российской Федерации. На основании решения Тверского районного суда г.Москвы от 21.03.2022 и требований ст. 10 ФЗ-114 в отношении компании Meta Platforms Inc.