Документация
Расчет платных вызовов
Расчет платных вызовов
Если ваш тариф основан на вызовах (запросах к OT API), то нужно правильно понимать, какие методы и в каких ситуациях считаются платными. И учитывать это в своей работе.
Прежде всего, платными являются только некоторая часть методов, в основном связанных с информацией от провайдеров: каталог, товары, поиск товаров, продавцы, и так далее. В данной документации платные методы помечены знаком .
Учитываются любые успешные с точки зрения OT API обращения к платным методам. Успешными считаются те вызовы, результат которых содержит код ошибки ErrorCode=Ok или ErrorCode=BatchError. Если клиент по каким-либо причинам не дождался ответа, но OT API все равно завершило выполнение без ошибок и выдало результат, вызов также считается успешным.
В качестве отдельного дополнения, почему код ошибки BatchError считается за успешный вызов: такой код ошибки может возникнуть только в Batch-методах, при ошибках в получении дополнительных блоков информации (как например блок со списком товаров того же продавца в методе BatchGetItemFullInfo). При этом основная информация метода (в примере - информация о самом товаре) возвращается как обычно, другие дополнительные блоки тоже могут быть успешно возвращены.
Некоторые запросы имеют динамическую стоимость, когда сразу начисляется вызовов, а не один. В данной документации методы с динамической стоимостью помечены знаком .
Массовые методы получения товаров, как правило, имеют динамическую стоимость по числу успешно полученных товаров.
Одиночные методы получения товаров, если в параметре itemParameters указан ForceUpdate, имеют динамическую стоимость в зависимости от провайдера, так как для каждого провайдера своя сложность немедленного обновления товара.
- Провайдеры Таобао/Tmall, 1688, Alibaba, AliExpress, JD, Amazon, Ebay - 5 вызовов.
- Pinduoduo - 25 вызовов. Важно! Только при использовании ForceUpdate гарантировано наличие информации о конфигурациях товара.