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

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

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

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

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

API URL

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

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

Authorization: Bearer token

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

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
}

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

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

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

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

Методы

getItemList

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

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

Отсутствуют

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

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

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

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

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

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

Отсутствуют

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

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

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

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

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

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

Отсутствуют

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

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

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

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

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

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

Отсутствуют

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

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

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

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

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

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

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

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

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

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

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

Отсутствуют

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

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

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

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

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

getCommonDescriptionList

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

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

Отсутствуют

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

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

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

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

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

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

    }

getSubCategory

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

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

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

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

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

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

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

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

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

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

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

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

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

Отсутствуют

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

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

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

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

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

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

getCountryList

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

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

Отсутствуют

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

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

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

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

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

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

getCitiesList

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

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

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

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

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

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

id=107

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

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

stopSale

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

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

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

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

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

id=328059

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

    {
        "id": "328059",

    }

relistItem

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

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

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

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

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

id=328059

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

    {
        "id": "328059",

    }

deleteItem

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

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

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

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

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

id=328059

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

    {
        "id": "328059",

    }

listItem

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

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

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

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

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

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

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

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

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

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
            }
        }
        
    }

Читать еще:

Частые вопросы