Новая версия
Загрузка ...
Все с рубля!
 
Интернет-аукцион Мешок

 -  руб.

Доставка

 
Премиум бренды
Увлеченным
Электрическое
Себе и любимым
Все в дом
Передвигаемся

Введение

• Как работает аукцион
• Зачем регистрироваться
• Как покупать
• Как продавать

Покупателям

• Как искать лоты
• Метки
• Лоты с фиксированными ценами
• Аукционные лоты
• Ограничения для покупателей
   • Автоставка
   • Блиц-цена
• Доставка и оплата
• Отзывы и рейтинг
• Запрос новых лотов
• Подписка на новые лоты
• Конфиденциальность сделок

Продавцам

• Выставление лота на продажу
• Промо лоты
• Метки
• Лот выставлен, что дальше?
• После окончания торгов
• Возврат комиссии
• Перевыставление лотов
• Статус «Проверенный продавец»
• Благотворительность
• Водяные знаки
• API

Безопасность

• Общие правила
• Советы покупателям
• Советы продавцам
• Видеозапись отправления

Дополнительно

• Правила торговли
• Частые вопросы и служба поддержки

API для продавцов

Автоматизируйте продажи своих товаров

Общее описание протокола.

С помощью API для продавцов Вы сможете управлять Вашими товарами на Мешке. Взаимодействие с сервером происходит по протоколу https, путем отправки POST запросов на API URL в кодировке UTF-8. Сервер возвращает ответ в формате JSON, кодировка UTF-8.

За каждый успешный вызов метода с API-счета списываются очки согласно этой таблице. За каждый успешный вызов метода relistItem (перевыставление лота) с API-счета списывается 2 очка, за каждый успешный вызов метода listItem (выставление лота на торги) - 10 очков.

МетодСтоимость (очки)Права доступа
getItemList10Чтение
getFinishedItemList10Чтение
getUnsoldFinishedItemList10Чтение
getSoldFinishedItemList10Чтение
getItemInfo1Чтение
getAccountInfo1Чтение
getCommonDescriptionList1Чтение
getSubCategory1Чтение
getCategoryInfo1Чтение
getCurencyList1Чтение
getCountryList1Чтение
getCitiesList1Чтение
stopSale0Запись
relistItem2Запись
deleteItem0Запись
listItem10Запись
updateItem1Запись


Пополнение API-счета осуществляется на странице управления API в профайле.
Стоимость 1000 очков для API-счета составляет 1 рубль.

Готовые билиблиотеки

API URL

https://api.meshok.net/sAPIv1/methodName

Заголовок авторизации

Authorization: Bearer token

methodName – название метода;
token – ключ доступа созданный в профайле, раздел API.

Пример запроса

POST https://api.meshok.net/sAPIv1/getCategoryInfo

id=140

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

{
    "success": 1,
    "result": {
        "id": "140",
        "name": "Коллекционное",
        "parentId": "0",
        "subCategories": true
    },
    "account": 99999,
    "cost": 1,
    "balance": 8853,
    "expire": 17813271
}

Параметры ответа

Параметр Тип Описание
success числовой Статус выполнения запроса
1 – успешное выполнение запроса;
отрицательное число – ошибка.
result объект Результат выполнения запроса. Присутствует в случае если success равен 1.
error строка Текстовое описание ошибки. Присутствует в случае если success является отрицательным числом.
account число Номер аккаунта пользователя.
cost число Стоимость выполнения запроса, удержанная с API-счета.
balance число Остаток на API-счете после выполнения запроса.
expire число Время в секундах до истечения действия ключа.

Авторизация и ограничения

Авторизация всех запросов осуществляется с помощью ключей доступа (token), которые Вы можете создать в своем профайле в разделе API. За ключом закрепляются права доступа (чтение, запись). Вы можете использовать до 10 ключей на один аккаунт.

Допускается не более одного обращения с одного IP в секунду.

Методы




getItemList

Получить список лотов, находящихся на продаже

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

Отсутствуют

Параметры ответа

Массив объектов с такими данными

idНомер лота.
saleTypeТип продажи. Принимает значение Sale или Auction - фиксированная цена или аукцион соответственно.
quantityДля лотов с фиксированной ценой: количество
soldПродано - для лотов с фиксированной ценой.
bidsКоличество ставок для аукционов.
priceЦена - для лотов с фиксированной ценой.
currentPriceТекущая цена для аукционов.
curencyIdИдентификатор валюты.

Пример запроса

POST https://api.meshok.net/sAPIv1/getItemList

Пример ответа (содержимое объекта result)

    {
        "0": {
            "id": "3828059",
            "saleType": "Auction",
            "bids": "5",
            "currentPrice": "22.00",
            "curencyId": "2"

        },
        "1": {
            "id": "382809",
            "saleType": "Sale",
            "quantity": "65",
            "sold": "6",
            "curencyId": "2",
            "price": "28.00"

        }
    }




getFinishedItemList

Получить список лотов, торги по которым завершены

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

Отсутствуют

Параметры ответа

Массив объектов с такими данными

idНомер лота.
newIdНовый id лота, если лот перевыставлен на повторные торги.
endDateTimeДата и время окончания торгов в формате "YYYY-MM-DD HH:MM:SS". NA - отсутствие даты окончания.
TZЧасовой пояс

Пример запроса

POST https://api.meshok.net/sAPIv1/getFinishedItemList

Пример ответа (содержимое объекта result)

    {
        "0": {
            "id": "3828059",
            "endDateTime": "2016-02-28 15:00:00",
            "TZ": "MSK"
        },
        "1": {
            "id": "382809",
            "endDateTime": "2016-02-23 15:20:00",
            "newId": "383999",
            "TZ": "MSK"
        }
    }




getUnsoldFinishedItemList

Получить список лотов, торги по которым завершены и по ним нет ни одной сделки

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

Отсутствуют

Параметры ответа

Массив объектов с такими данными

idНомер лота.
newIdНовый id лота, если лот перевыставлен на повторные торги.
endDateTimeДата и время окончания торгов в формате "YYYY-MM-DD HH:MM:SS". NA - отсутствие даты окончания.
TZЧасовой пояс

Пример запроса

POST https://api.meshok.net/sAPIv1/getUnsoldFinishedItemList

Пример ответа (содержимое объекта result)

    {
        "0": {
            "id": "3828059",
            "endDateTime": "2016-02-28 15:00:00",
            "TZ": "MSK"

        },
        "1": {
            "id": "382809",
            "endDateTime": "2016-02-23 15:20:00",
            "newId": "383999",
            "TZ": "MSK"
        }
    }




getSoldFinishedItemList

Получить список лотов, торги по которым завершены и по ним есть сделки

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

Отсутствуют

Параметры ответа

Массив объектов с такими данными

idНомер лота.
orderIdНомер сделки.
quantityКоличество предметов в сделке.
happendФлаг состояния сделки. Возможные значения:
null - статус сделки не определен продавцом;
Y - сделка состоялась;
N - сделка не состоялась.
newIdНовый id лота, если лот перевыставлен на повторные торги.
endDateTimeДата и время окончания торгов в формате "YYYY-MM-DD HH:MM:SS". NA - отсутствие даты окончания.
TZЧасовой пояс

Пример запроса

POST https://api.meshok.net/sAPIv1/getSoldFinishedItemList

Пример ответа (содержимое объекта result)

    {
        "0": {
            "id": "35386793",
            "endDateTime": "2016-02-23 15:20:00",
            "orderId": "1240176",
            "quantity": "1",
            "happend": null,
            "newId": null,
            "TZ": "MSK"
        },
        "1": {
            "id": "37824245",
            "endDateTime": "2016-02-23 15:20:00",
            "orderId": "1968160",
            "quantity": "1",
            "happend": "N",
            "newId": "37824850",
            "TZ": "MSK"
        }
    }




getItemInfo

Получить информацию о лоте

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

idНомер лота.

Параметры ответа

idНомер лота.
nameНаименование лота
categoryНомер тематического раздела
saleTypeТип продажи. Принимает значение Sale или Auction - фиксированная цена или аукцион соответственно.
longevityПродолжительность торгов в днях. Для аукционов может принимать значения 3,5,7,10,14,21. Для лотов с фиксированной ценой 30 и 100. 100 означает без срока окончания для подписчиков на т.п. Продавец.
listDateTimeДата и время выставления лота на продажу.
endDateTimeДата и время окончания торгов в формате "YYYY-MM-DD HH:MM:SS". NA - отсутствие даты окончания.
prolongДля аукционов: количество продлений в случае неудачных торгов.
prolongDoneДля аукционов: количество осуществленных продлений.
startPriceДля аукционов: начальная цена.
currentPriceДля аукционов: текущая цена.
priceЦена - для товаров с фиксированной ценой.
strikePriceДля аукционов: цена Купить сейчас.
antisniperДля аукционов: Опция автопродление
Y - да
N - нет.
bestOfferТорг уместен
Y - да
N - нет.
curencyIdИдентификатор валюты.
bidsДля аукционов: количество ставок на лот.
quantityКоличество
soldКоличество проданных экземпляров лота для товаров с фиксированной ценой.
notifyДля аукционов: флаг оповещения о новый ставках на лот
Y - оповещать
N - не оповещать.
tagsМетки лота через запятую
categoryParamsНомера дополнительных параметров лота через запятую.
boldВыделение жирным в списке лотов
Y - да
N - нет.
recommendedПромо лот
Y - да
N - нет.
paymentСпособы оплаты за лот. Один или несколько способов оплаты за лот из списка через запятую:
CASH - наличные
BANK - банковский перевод
NALOZH - наложенный платеж
CARD - перевод на банковскую карту
YANDEX - ЮMoney (Яндекс.Деньги)
WEBMONEY - WebMoney
CONTACT - переводы Contact
TERMINAL - Оплат через терминал
MAIL - Почтовый перевод
PAYPAL - PayPal
BITCOIN - Биткоины
DESC - подробности в описании.
localDeliveryДоставка по городу (одно из значений)
SELF - самовывоз
FREE - бесплатно
CHARGE - за плату
localDeliveryPriceСтоимость доставки по городу
0.00 - уточняйте стоимость доставки дополнительно
>0 - стоимость в валюте цены.
deliveryДоставляется ли лот за пределы города
NO - не доставляется
COUNTRY - доставляется по стране
WORLD - доставляется по стране и миру.
countryDeliveryPriceСтоимость доставки по стране
-1.00 - бесплатно
0.00 - уточняйте стоимость доставки дополнительно
>0 - стоимость в валюте цены.
worldDeliveryPriceСтоимость доставки по миру
-1.00 - бесплатно
0.00 - уточняйте стоимость доставки дополнительно
>0 - стоимость в валюте цены.
minimalBuyerRateМинимальный рейтинг покупателя. Число в диапазоне от 0 до 9.
conditionСостояние товара
used - бывший в употреблении
new - новый
NA - не указано.
numberOfPicturesКоличество изображений лота.
cityИдентификатор города, в котором расположен лот.
statusСтатус лота
deferred - отложенный старт
draft - черновик
listed - на продаже
finished - торги завершены
deleted - удален.
newIdНовый id лота, если лот перевыставлен на повторные торги.
deliveryTextДополнительная информация о доставке и оплате. Текст до 1000 символов.
descriptionОписание лота. Может быть использован HTML. Допустимые тэги: <H1> <H2> <H3> <H4> <H5> <H6> <A> <BR> <P> <IMG> <TABLE> <TBODY> <TR> <TD> <HR> <OL> <LI> <UL> <PRE> <ADDRESS> <DIR> <MENU> <DL> <DT> <DD> <FONT> <STRONG> <EM> <U> <STRIKE> <B> <I> <BLOCKQUOTE> <S> <TT> <CENTER> <STYLE> <span> <div> <iframe>
commonDescriptionsСписок идентификаторов стандартных описаний для лота через запятую.
TZЧасовой пояс.

Пример запроса

POST https://api.meshok.net/sAPIv1/getItemInfo

id=328059

Пример ответа (содержимое объекта result)

    {
        "id": "328059",
        "name": "Розовый слон",
        "category": "2182",
        "saleType": "Auction",
        "longevity": "7",
        "listDateTime": "2016-03-01 22:14:34",
        "endDateTime": "2016-03-08 22:14:34",
        "prolong": "2",
        "prolongDone": "0",
        "startPrice": "1.00",
        "currentPrice": "42.00",
        "strikePrice": "333.00",
        "antisniper": "N",
        "bestOffer": "N",
        "curencyId": "2",
        "bids": "5",
        "quantity": "1",
        "notify": "Y",
        "tags": "слон,фауна,домашние животные",
        "categoryParams": "324,656,22465",
        "bold": "N",
        "recommended": "Y",
        "payment": "CASH,CARD,DESC",
        "localDelivery": "CHARGE",
        "localDeliveryPrice": "234.00",
        "delivery": "COUNTRY",
        "countryDeliveryPrice": "-1.00",
        "worldDeliveryPrice": "0.00",
        "minimalBuyerRate": "3",
        "condition": "used",
        "numberOfPictures": "2",
        "city": "32",
        "status": "finished",
        "newId": null,
        "deliveryText": "Доставка своим ходом.",
        "description": "Слон немного бу, но в отлично состоянии.<h1>Налетай!</h1>",
        "commonDescriptions": "964,33",
        "TZ": "MSK"

    }




getAccountInfo

Получить информацию об аккаунте

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

Отсутствуют

Параметры ответа

checkedSellerСтатус проверенного продавца ( Y - Да, N - Нет)
cityIdID города регистрации
countryIdID страны регистрации

Пример запроса

POST https://api.meshok.net/sAPIv1/getAccountInfo

Пример ответа (содержимое объекта result)

    {
        "checkedSeller": "N",
        "cityId": "32",
        "categoryId": "107"
    }




getCommonDescriptionList

Получить список стандартных описаний

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

Отсутствуют

Параметры ответа

Массив объектов с такими данными

idИдентификатор стандартного описания.
nameНазвание стандартного описания.
commonDescriptionТекст стандартного описания. Может быть использован HTML. Допустимые тэги: <H1> <H2> <H3> <H4> <H5> <H6> <A> <BR> <P> <IMG> <TABLE> <TBODY> <TR> <TD> <HR> <OL> <LI> <UL> <PRE> <ADDRESS> <DIR> <MENU> <DL> <DT> <DD> <FONT> <STRONG> <EM> <U> <STRIKE> <B> <I> <BLOCKQUOTE> <S> <TT> <CENTER> <STYLE> <span> <div> <iframe>

Пример запроса

POST https://api.meshok.net/sAPIv1/getCommonDescriptionList

Пример ответа (содержимое объекта result)

    {
        "0": {
            "id": "964",
            "name": "Для всех лотов",
            "commonDescription": "<p>В случае заказа нескольких лотов - скидка!<\/p>"
        },
        "1": {
            "id": "1628",
            "name": "Новые поступления",
            "commonDescription": "Зеленый слон, желтый слон, ..."
        }

    }




getSubCategory

Получить список подразделов

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

idИдентификатор родительского раздела.

Параметры ответа

Массив объектов с такими данными

idИдентификатор тематического раздела.
nameНазвание тематического раздела.
subCategoriesНаличие подразделов, принимает значения
true - подразделы есть
false - подразделов нет.
recommendedPriceТолько для разделов без подразделов: Стоимость услуги Промо лот для данного раздела в рублях.

Пример запроса

POST https://api.meshok.net/sAPIv1/getSubCategory

id=252

Пример ответа (содержимое объекта result)

    { 
        "0": {
            "id": "14259",
            "name": "Сувенирные монеты",
            "subCategories": true
        },
        "1": {
            "id": "1798",
            "name": "Другие",
            "subCategories": false,
            "recommendedPrice": "5"
        }
   }




getCategoryInfo

Получить информацию о тематическом разделе

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

idИдентификатор тематического раздела.

Параметры ответа

idИдентификатор тематического раздела.
nameНазвание тематического раздела.
parentIdИдентификатор родительского раздела.
subCategoriesНаличие подразделов, принимает значения
true - подразделы есть
false - подразделов нет.
recommendedPriceТолько для разделов без подразделов: Стоимость услуги Промо лот для данного раздела в рублях.
paramsЦифровые идентификаторы параметров раздела, предназначенные для использования в поле categoryParams методов listItem и updateItem.

В случае, если признак multi установлен в значение true, то у данного параметра допускается использование нескольких опций для одного лота.

Пример запроса

POST https://api.meshok.net/sAPIv1/getCategoryInfo

id=1798

Пример ответа (содержимое объекта result)

    {
        "id": "1798",
        "name": "Другие",
        "parentId": "252",
        "subCategories": false,
        "recommendedPrice": 99,
        "params": {
				
            "Состояние": {
                "type": "options",
                "multi": false,
                "options": {
                    "Гашеная": 437,
                    "Чистая": 436
                }
            },

            "Набор": {
                "type": "checkbox",
                "id": "11452"
            },

            "Тематика": {
                "type": "options",
                "multi": true,
                "options": {
                    "Августейшие семьи": 624,
                    "Авторские": 627,
                    "Артистические": 630,
                    "Виды городов": 621,
                    "Географические": 637,
                    "Гламурные": 629,
                    "Дети": 15580,
                    "Милитария": 625,
                    "Необычные": 635,
                    "Персональные": 631,
                    "Поздравительные": 623,
                    "Политические": 626,
                    "Прочие": 639,
                    "Рекламные": 632,
                    "Религиозные": 636,
                    "Спортивные": 638,
                    "Транспортные": 633,
                    "Флора и Фауна": 634,
                    "Художественные": 628,
                    "Этнографические": 622
                }
            }
          }	
       }
    }




getCurencyList

Получить список список валют

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

Отсутствуют

Параметры ответа

Массив объектов с такими данными

idИдентификатор валюты.
symbolНазвание валюты по стандарту ISO 4217

Пример запроса

POST https://api.meshok.net/sAPIv1/getCurencyList

Пример ответа (содержимое объекта result)

   {
        "0": {
            "id": "1",
            "symbol": "USD"
        },
        "1": {
            "id": "2",
            "symbol": "RUB"
        },
        "2": {
            "id": "3",
            "symbol": "EUR"
        } 
    }




getCountryList

Получить список стран

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

Отсутствуют

Параметры ответа

Массив объектов с такими данными

idИдентификатор страны.
nameНазвание страны

Пример запроса

POST https://api.meshok.net/sAPIv1/getCountryList

Пример ответа (содержимое объекта result)

   {
        "0": {
            "id": "1",
            "name": "Россия"
        },
        "1": {
            "id": "2",
            "name": "Америка"
        },
        "2": {
            "id": "3",
            "name": "Китай"
        } 
    }




getCitiesList

Получить список городов в стране

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

idИдентификатор страны.

Параметры ответа

Массив объектов с такими данными

idИдентификатор города.
nameНазвание города

Пример запроса

POST https://api.meshok.net/sAPIv1/getCitiesList

id=107

Пример ответа (содержимое объекта result)

   {
        "0": {
            "id": "1",
            "name": "Москва"
        },
        "1": {
            "id": "2",
            "name": "Санкт-Петербург"
        },
        "2": {
            "id": "3",
            "name": "Владивосток"
        } 
    }




stopSale

Снять лот с продажи

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

idНомер лота.

Параметры ответа

idНомер лота.

Пример запроса

POST https://api.meshok.net/sAPIv1/stopSale

id=328059

Пример ответа (содержимое объекта result)

    {
        "id": "328059",

    }




relistItem

Перевыставить лот на повторные торги.

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

idНомер лота.

Параметры ответа

idНомер нового лота.

Пример запроса

POST https://api.meshok.net/sAPIv1/relistItem

id=328059

Пример ответа (содержимое объекта result)

    {
        "id": "328059",

    }




deleteItem

Удалить лот из списка завершенных.

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

idНомер лота.

Параметры ответа

idНомер удаленного лота.

Пример запроса

POST https://api.meshok.net/sAPIv1/deleteItem

id=328059

Пример ответа (содержимое объекта result)

    {
        "id": "328059",

    }




listItem

Выставить лот на продажу

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

nameНаименование лота. Максимальная длина 100 символов.
categoryНомер тематического раздела
saleTypeТип продажи. Возможные значения: Sale или Auction - фиксированная цена или аукцион соответственно.
curencyIdИдентификатор валюты.
tagsМетки лота через запятую, максимальная длина 300 символов.
categoryParamsНомера дополнительных параметров лота через запятую. Список допустимых значений можно получить с помощью метода getCategoryInfo. Неподходящие для раздела параметры будут проигнорированы. Максимальная длина 255 символов.
boldВыделение жирным в списке лотов
Y - да
N - нет.
recommendedПромо лот
Y - да
N - нет.
paymentСпособы оплаты за лот. Один или несколько способов оплаты за лот из списка через запятую:
CASH - наличные
BANK - банковский перевод
NALOZH - наложенный платеж
CARD - перевод на банковскую карту
YANDEX - ЮMoney (Яндекс.Деньги)
WEBMONEY - WebMoney
CONTACT - переводы Contact
TERMINAL - Оплат через терминал
MAIL - Почтовый перевод
PAYPAL - PayPal
BITCOIN - Биткоины
DESC - подробности в описании.
localDeliveryДоставка по городу (одно из значений)
SELF - самовывоз
FREE - бесплатно
CHARGE - за плату
localDeliveryPriceСтоимость доставки по городу
0.00 - уточняйте стоимость доставки дополнительно
>0 - стоимость в валюте цены.
deliveryДоставляется ли лот за пределы города
NO - не доставляется
COUNTRY - доставляется по стране
WORLD - доставляется по стране и миру.
countryDeliveryPriceCтоимость доставки по стране
-1.00 - бесплатно
0.00 - уточняйте стоимость доставки дополнительно
>0 - стоимость в валюте цены.
worldDeliveryPriceCтоимость доставки по миру
-1.00 - бесплатно
0.00 - уточняйте стоимость доставки дополнительно
>0 - стоимость в валюте цены.
minimalBuyerRateМинимальный рейтинг покупателя. Число в диапазоне от 0 до 9. 0 - любой рейтинг.
conditionСостояние товара
used - бывший в употреблении
new - новый
NA - не указано.
cityИдентификатор города, в котором расположен лот.
deliveryTextДополнительная информация о доставке и оплате. Текст до 1000 символов.
descriptionОписание лота. Может быть использован HTML. Допустимые тэги: <H1> <H2> <H3> <H4> <H5> <H6> <A> <BR> <P> <IMG> <TABLE> <TBODY> <TR> <TD> <HR> <OL> <LI> <UL> <PRE> <ADDRESS> <DIR> <MENU> <DL> <DT> <DD> <FONT> <STRONG> <EM> <U> <STRIKE> <B> <I> <BLOCKQUOTE> <S> <TT> <CENTER> <STYLE> <span> <div> <iframe>
commonDescriptionsСписок идентификаторов стандартных описаний для лота через запятую.
picturesСписок URL изображений лота через запятую.
longevityПродолжительность торгов в днях. Для аукционов может принимать значения 3,5,7,10,14,21. Для лотов с фиксированной ценой 30 и 100. 100 означает без срока окончания для подписчиков на т.п. Продавец.
listDateTimeДата и время выставления лота на продажу в формате "YYYY-MM-DD HH:MM:SS". Принимаются к размещению лоты, чья дата размещения отстоит от текущего времени не более чем на 30 дней.
startPriceДля аукционов: начальная цена. Положительное число больше нуля. Минимум 0.01, максимум 100000000.00.
strikePriceДля аукционов: цена Купить сейчас. Положительное число больше нуля. Минимум 0.01, максимум 100000000.00.
antisniperДля аукционов: Опция автопродление
Y - да
N - нет.
bestOfferТорг уместен
Y - да
N - нет.
notifyДля аукционов: флаг оповещения о новый ставках на лот
Y - оповещать
N - не оповещать.
prolongДля аукционов: количество продлений в случае неудачных торгов.
priceДля лотов с фиксированной ценой: цена. Положительное число больше нуля. Минимум 0.01, максимум 100000000.00.
quantityДля лотов с фиксированной ценой: Количество

Параметры ответа

idНомер нового лота.
endDateTimeДата и время окончания торгов в формате "YYYY-MM-DD HH:MM:SS". NA - отсутствие даты окончания.
TZЧасовой пояс.
billingИнформация об оказанных платных услугах в виде объекта, где ключами являются названия заказанных платных услуг. В каждом ключе возвращаются следующие поля:
success: 0 - услуга не оказана; 1 - услуга оказана.
html - текстовое описание ошибки или сообщения об успешном оказании услуги в HTML формате.
price - стоимость оказанной услуги в рублях.

Пример запроса

POST https://api.meshok.net/sAPIv1/listItem

name=Розовый слон&category=2182&saleType=Auction&longevity=7&prolong=2&startPrice=1.00&strikePrice=333.00&antisniper=N&curencyId=2&notify=Y&tags=слон,фауна,домашние животные&categoryParams=324,656,22465&payment=CASH,CARD,DESC&localDelivery=CHARGE&localDeliveryPrice=49.00&delivery=COUNTRY&countryDeliveryPrice=-1.00&minimalBuyerRate=1&condition=used&city=32&deliveryText=Доставка своим ходом.&description=Слон немного бу, но в отлично состоянии.<h1>Налетай</h1>&commonDescriptions=64,33&pictures=http://exmple.com/pic/1.jpg,http://exmple.com/pic/2.jpg

Пример ответа (содержимое объекта result)

    {
        "id": "328059",
        "endDateTime": "2016-03-08 22:14:34",
        "TZ": "MSK",
        "billing": {
            "bold": {
                "price": 9,
                "html": "Услуга \"Жирный шрифт\" для лота 38354794 добавлена. С Вашего счета списано 9 р.",
                "success": 1
            },
            "recommended": {
                "price": 8,
                "html": "Услуга \"Промо лот\" для лота 38354794 добавлена. С Вашего счета списано 8 р.",
                "success": 1
            }
        }
        
    }




updateItem

Изменить параметры существующего лота.

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

idИдентификатор лота.
nameНаименование лота. Максимальная длина 100 символов.
categoryНомер тематического раздела
saleTypeТип продажи. Возможные значения: Sale или Auction - фиксированная цена или аукцион соответственно.
curencyIdИдентификатор валюты.
tagsМетки лота через запятую, максимальная длина 300 символов.
categoryParamsНомера дополнительных параметров лота через запятую. Список допустимых значений можно получить с помощью метода getCategoryInfo. Неподходящие для раздела параметры будут проигнорированы. Максимальная длина 255 символов.
boldВыделение жирным в списке лотов
Y - да
N - нет.
recommendedПромо лот
Y - да
N - нет.
paymentСпособы оплаты за лот. Один или несколько способов оплаты за лот из списка через запятую:
CASH - наличные
BANK - банковский перевод
NALOZH - наложенный платеж
CARD - перевод на банковскую карту
YANDEX - ЮMoney (Яндекс.Деньги)
WEBMONEY - WebMoney
CONTACT - переводы Contact
TERMINAL - Оплат через терминал
MAIL - Почтовый перевод
PAYPAL - PayPal
BITCOIN - Биткоины
DESC - подробности в описании.
localDeliveryДоставка по городу (одно из значений)
SELF - самовывоз
FREE - бесплатно
CHARGE - за плату
localDeliveryPriceСтоимость доставки по городу
0.00 - уточняйте стоимость доставки дополнительно
>0 - стоимость в валюте цены.
deliveryДоставляется ли лот за пределы города
NO - не доставляется
COUNTRY - доставляется по стране
WORLD - доставляется по стране и миру.
countryDeliveryPriceCтоимость доставки по стране
-1.00 - бесплатно
0.00 - уточняйте стоимость доставки дополнительно
>0 - стоимость в валюте цены.
worldDeliveryPriceCтоимость доставки по миру
-1.00 - бесплатно
0.00 - уточняйте стоимость доставки дополнительно
>0 - стоимость в валюте цены.
minimalBuyerRateМинимальный рейтинг покупателя. Число в диапазоне от 0 до 9. 0 - любой рейтинг.
conditionСостояние товара
used - бывший в употреблении
new - новый
NA - не указано.
cityИдентификатор города, в котором расположен лот.
deliveryTextДополнительная информация о доставке и оплате. Текст до 1000 символов.
descriptionОписание лота. Может быть использован HTML. Допустимые тэги: <H1> <H2> <H3> <H4> <H5> <H6> <A> <BR> <P> <IMG> <TABLE> <TBODY> <TR> <TD> <HR> <OL> <LI> <UL> <PRE> <ADDRESS> <DIR> <MENU> <DL> <DT> <DD> <FONT> <STRONG> <EM> <U> <STRIKE> <B> <I> <BLOCKQUOTE> <S> <TT> <CENTER> <STYLE> <span> <div> <iframe>
picturesСписок URL изображений лота через запятую.
commonDescriptionsСписок идентификаторов стандартных описаний для лота через запятую.
longevityПродолжительность торгов в днях. Для аукционов может принимать значения 3,5,7,10,14,21. Для лотов с фиксированной ценой 30 и 100. 100 означает без срока окончания для подписчиков на т.п. Продавец.
startPriceДля аукционов: начальная цена. Положительное число больше нуля. Минимум 0.01, максимум 100000000.00.
strikePriceДля аукционов: цена Купить сейчас. Положительное число больше нуля. Минимум 0.01, максимум 100000000.00.
antisniperДля аукционов: Опция автопродление
Y - да
N - нет.
bestOfferТорг уместен
Y - да
N - нет.
notifyДля аукционов: флаг оповещения о новый ставках на лот
Y - оповещать
N - не оповещать.
prolongДля аукционов: количество продлений в случае неудачных торгов.
priceДля лотов с фиксированной ценой: цена. Положительное число больше нуля. Минимум 0.01, максимум 100000000.00.
quantityДля лотов с фиксированной ценой: Количество

Параметры ответа

idНомер лота.
endDateTimeДата и время окончания торгов в формате "YYYY-MM-DD HH:MM:SS". NA - отсутствие даты окончания.
TZЧасовой пояс.
billingИнформация об оказанных платных услугах в виде объекта, где ключами являются названия заказанных платных услуг. В каждом ключе возвращаются следующие поля:
success: 0 - услуга не оказана; 1 - услуга оказана.
html - текстовое описание ошибки или сообщения об успешном оказании услуги в HTML формате.
price - стоимость оказанной услуги в рублях.

Пример запроса

POST https://api.meshok.net/sAPIv1/updateItem

id=328059&category=2182&saleType=Auction&longevity=7&prolong=2&startPrice=2.00&strikePrice=335.00&antisniper=N&curencyId=2&notify=Y&tags=слон,фауна,домашние животные,elefant&categoryParams=324,656,22465&payment=CASH,CARD&localDelivery=CHARGE&localDeliveryPrice=49.00&delivery=COUNTRY&countryDeliveryPrice=-1.00&minimalBuyerRate=1&condition=used&city=32&deliveryText=Доставка своим ходом.&description=Слон немного бу, но в отлично состоянии.<h1>Налетай</h1>&commonDescriptions=64

Пример ответа (содержимое объекта result)

    {
        "id": "328059",
        "endDateTime": "2016-03-08 22:14:34",
        "TZ": "MSK",
        "billing": {
            "bold": {
                "price": 9,
                "html": "Услуга \"Жирный шрифт\" для лота 38354794 добавлена. С Вашего счета списано 9 р.",
                "success": 1
            },
            "recommended": {
                "price": 8,
                "html": "Услуга \"Промо лот\" для лота 38354794 добавлена. С Вашего счета списано 8 р.",
                "success": 1
            }
        }
        
    }

Читать еще:


Частые вопросы
Увлеченным
Электрическое
Себе и любимым
Все в дом
Передвигаемся
Все права защищены 1999-2023 Мешок

Tue, 19 Mar 2024 05:38:51 +0300