API — Используйте наши алгоритмы и базу данных, на своей площадке!

Подробнее..
Главное
Для работы с API вам необходимо получить IDUSER и KEYUSER. Они выдаются только зарегистрированным пользователям.
Если Вы уже зарегистрированы на нашем сайте, то для получения IDUSER и KEYUSER, Вам необходимо зайти в раздел "Профиль" —> "Настройки профиля" —> "Безопасность и сервисы" —> "Запросить IDUSER и KEYUSER".
Срок рассмотрения заявки можен занимать до 72 часов с момента ее подачи.
Также, если у Вас имеются идеи, пожелания или предложения по улучшению API — пишите на E-Mail: market@posuda18.ru. Мы открыты для предложений и рассмотрим любую Вашу идею!
Общее
Обратите внимание! Тело ответа на 1 запрос может содержать в себе максимум 100 товаров на 1 странице.
Сделано это ограничение для того, чтобы товары могли своевременно и корректно подгружаться.
Рекомендуем за 1 запрос получать до 500 товаров. Среднее время подгрузки 100 товаров — до 25 секунд.
Для получения активных товаров (в возрастающем порядке), необходимо выполнить следующий GET запрос:
GET
https://posuda18.ru/api?method=goods&id_user=IDUSER&key_user=KEYUSER
IDUSER и KEYUSER — необходимо заменить на Ваши значения.
В ответе будет получено до 1000 товаров, начиная с первого по его id.
Чтобы подгрузить товары в убывающем порядке, используйте параметр "filter"=desc.
Если не использовать данный параметр, тогда товары будут подгружаться в возрастающем порядке.
Пример запроса:
GET
https://posuda18.ru/api?method=goods&id_user=IDUSER&key_user=KEYUSER&filter=desc
В ответе будет получено до 1000 товаров, начиная с последнего по его id.
С помощью параметра "sorting" можно сортировать товары.
"sorting"=articul — сортировка товаров по артикулам, "sorting"=name — сортировка товаров по наименованиям, "sorting"=price — сортировка товаров по ценам, "sorting"=ostatok — сортировка товаров по остаткам.
Данные параметры совместимы с параметром "filter". При совместном использовании данных параметров с параметром "filter" — товары подгрузятся в убывающем порядке, без использования параметра "filter" — товары подгрузятся в возрастающем порядке.
Пример запроса:
GET
https://posuda18.ru/api?method=goods&id_user=IDUSER&key_user=KEYUSER&sorting=price
В ответе будет получено до 1000 товаров в возрастяющем порядке по цене (если использовать "filter"=desc, тогда товары будут подгружены в убывающем порядке по цене).
Также есть возможность порционной подгрузки данных (получение более 1000 товаров).
Для этого необходимо указать параметр "page". Таким образом, при указании "page"=1 — будут подгружены первые 1000 товаров, при указании "page"=2 — будут подгружены следующие 1000 товаров и так далее..
Пример запроса:
GET
https://posuda18.ru/api?method=goods&id_user=IDUSER&key_user=KEYUSER&page=1
1 — номер страницы.
Если необходимо получить на одной странице определенное количество товаров, например 10, для этого используйте параметр "limit". Таким образом, при указании "limit"=10 — будет подгружено 10 товаров.
Пример запроса:
GET
https://posuda18.ru/api?method=goods&id_user=IDUSER&key_user=KEYUSER&limit=10
10 — количество подгружаемых товаров на странице.
Можно использовать параметр "page" и "limit" в одном запросе. Благодаря этому произойдет порциональная подгрузка.
Пример запроса:
GET
https://posuda18.ru/api?method=goods&id_user=IDUSER&key_user=KEYUSER&page=2&limit=10
В ответе будет подгружено 10 товаров, начиная с 11-го по его id.
Для получения товара по его артикулу, используйте параметр "articul".
Пример запроса:
GET
https://posuda18.ru/api?method=goods&id_user=IDUSER&key_user=KEYUSER&articul=КТ868
В ответе будет подгружен единственный товар с указанным в запросе артикулом (КТ868).
Данным параметром возможно получить только 1 товар.
Также можно воспользоваться параметром "search". Он служит для поиска товаров. С данным параметром возможно получить до 1000 товаров на 1 странице.
Работает по принципу стандртного получения товаров (совместим с параметрами "page" и "limit", благодаря чему имеется возможность порциональной подгрузки).
Поиск заданных значений проиходит по артикулам и наименованиям.
Пример запроса:
GET
https://posuda18.ru/api?method=goods&id_user=IDUSER&key_user=KEYUSER&search=Мантоварка
В ответе будут подгружены все товары, у которых в наименовании имеется слово "Мантоварка".
Вместа слова "Мантоварка" можно использовать часть слова, например "Манто". Товары найдутся.
Пример успешного ответа (тело):
JSON
{
"status": true,
"all_goods": 5934,
"loaded_goods": 1,
"goods": {
"27464": {
"id": "b05db72b-7052-11e7-a32f-0018f3868359",
"articul": "КТ868",
"name": "Ложка столовая BAZIS Luxstah Нержавеющая сталь 18/0 толщина 1,8*длина 180мм/ КК",
"price": "33.00",
"price_opt": "30.00",
"currency": "RUB",
"ostatok": "30",
"similar": ["54695","54732","51996","54721","58390"],
"characteristics": {
"material": {
"id": "3517d257-fd7f-11e5-a56b-0018f3868359",
"name": "Материал",
"value": "Нержавеющая сталь"
},
"manufacturer": {
"id": "3517d258-fd7f-11e5-a56b-0018f3868359",
"name": "Производитель",
"value": "КИТАЙ"
},
"height_box": {
"id": "f5dbc017-9783-11eb-a72c-b42e998e7642",
"name": "Высота упаковки",
"value": "25"
},
"width_box": {
"id": "f5dbc018-9783-11eb-a72c-b42e998e7642",
"name": "Ширина упаковки",
"value": "5"
},
"length_box": {
"id": "f5dbc019-9783-11eb-a72c-b42e998e7642",
"name": "Длина (Глубина) упаковки",
"value": "5"
},
"weight_box": {
"id": "f5dbc019-9783-11eb-a72c-b42e998e7642",
"name": "Масса упаковки",
"value": "5"
}
},
"description": "Отличная столовая ложка, из прочной, а также нержавеющей стали, которая подойдет под любой тип кухни!",
"category": {
"id": "d7ff8e7e-5fef-11e6-8cf3-0018f3868359",
"name": "Столовые приборы",
"roditel_category": {
"id": "d7ff8e6c-5fef-11e6-8cf3-0018f3868359",
"name": "Сервировка",
"roditel_category": {
"id": "7b27762a-5e44-11e6-846b-0018f3868359",
"name": "Посуда"
}
}
},
"video": {
"video_url": "...",
"cover_url": "..."
},
"photos": {
"0": "https://posuda18.ru/files/images/goods/18222_photos_l.jpg"
}
},
...
}
}
Описание полей
status — Статус (true — запрос выполнен успешно, false — ошибка при выполнении запроса)
all_goods — Общее количество активных товаров
loaded_goods — Подгруженное количество товаров
goods — Товары
id — Уникальный номер
articul — Артикул
name — Наименование
price — Розничная цена
price_opt — Оптовая цена
currency — Валюта
ostatok — Остаток (если более 30, то всегда возвращается 30)
similar — Артикула привязанных товаров
characteristics — Характеристики
material — Материал
manufacturer — Производитель
volume — Объем (л)
weight — Масса (кг)
height — Высота (см)
width — Ширина (см)
length — Длина/Глубина (см)
diameter — Диаметр (см)
height_box — Высота упаковки (см)
width_box — Ширина упаковки (см)
length_box — Длина/Глубина упаковки (см)
weight_box — Масса упаковки (кг)
color — Цвет
series — Серия
value — Значение
unit — Ед. измерения
description — Описание
category — Категория
roditel_category — Родительская категория
video — Видео
video_url — Ссылка на видео
cover_url — Ссылка на обложку
photos — Фотографии (0 — главная)
Среднее время подгрузки характеристик — до 5 секунд.
Для получения активных характеристик, необходимо выполнить следующий GET запрос:
GET
https://posuda18.ru/api?method=characteristics&id_user=IDUSER&key_user=KEYUSER
IDUSER и KEYUSER — необходимо заменить на Ваши значения.
В ответе будет получено до 1000 характеристик, начиная с первой по ее id.
Пример успешного ответа (тело):
JSON
{
"status": true,
"all_characteristics": 16,
"loaded_characteristics": 16,
"characteristics": {
"0": {
"id": "1a9ad9fe-3df1-11ea-b56f-0018f3868359",
"name": "Цвет"
},
"1": {
"id": "1a9ad9ff-3df1-11ea-b56f-0018f3868359",
"name": "Ширина"
},
"2": {
"id": "3517d257-fd7f-11e5-a56b-0018f3868359",
"name": "Материал"
},
"3": {
"id": "3517d258-fd7f-11e5-a56b-0018f3868359",
"name": "Производитель"
},
"4": {
"id": "70e18712-21da-11ed-a73b-b42e998e7642",
"name": "Длина (Глубина)"
},
"5": {
"id": "811bab78-c737-11e5-8de2-0018f3868359",
"name": "Серия"
},
"6": {
"id": "811bab7a-c737-11e5-8de2-0018f3868359",
"name": "Объем"
},
"7": {
"id": "811bab7b-c737-11e5-8de2-0018f3868359",
"name": "Масса"
},
"8": {
"id": "811bab7c-c737-11e5-8de2-0018f3868359",
"name": "Высота"
},
"9": {
"id": "811bab7d-c737-11e5-8de2-0018f3868359",
"name": "Диаметр"
},
"10": {
"id": "8c8adb28-c8a5-11e9-8e5b-0018f3868359",
"name": "Материал (не исп.)"
},
"11": {
"id": "f5dbc017-9783-11eb-a72c-b42e998e7642",
"name": "Высота коробки"
},
"12": {
"id": "f5dbc018-9783-11eb-a72c-b42e998e7642",
"name": "Ширина коробки"
},
"13": {
"id": "f5dbc019-9783-11eb-a72c-b42e998e7642",
"name": "Длина (Глубина) коробки"
},
"14": {
"id": "f5dbc01a-9783-11eb-a72c-b42e998e7642",
"name": "Вес коробки"
}
}
}
Описание полей
status — Статус (true — запрос выполнен успешно, false — ошибка при выполнении запроса)
all_manufacturers — Общее количество активных производителей
loaded_manufacturers — Подгруженное количество производителей
manufacturers — Характеристики (л — объем, кг — масса, см — размер)
id — Уникальный номер
name — Наименование
Обратите внимание! Тело ответа на 1 запрос может содержать в себе максимум 1000 категорий на 1 странице.
Сделано это ограничение для того, чтобы категории могли своевременно и корректно подгружаться.
Рекомендуем за 1 запрос получать до 500 категорий. Среднее время подгрузки 1000 категорий — до 5 секунд.
Для получения активных категорий (в возрастающем порядке), необходимо выполнить следующий GET запрос:
GET
https://posuda18.ru/api?method=categories&id_user=IDUSER&key_user=KEYUSER
IDUSER и KEYUSER — необходимо заменить на Ваши значения.
В ответе будет получено до 1000 категорий, начиная с первой по ее id.
Чтобы подгрузить категории в убывающем порядке, используйте параметр "filter"=desc.
Если не использовать данный параметр, тогда товары будут подгружаться в возрастающем порядке.
Пример запроса:
GET
https://posuda18.ru/api?method=categories&id_user=IDUSER&key_user=KEYUSER&filter=desc
В ответе будет получено до 1000 категорий, начиная с последней по ее id.
Также есть возможность порционной подгрузки данных (получение более 1000 категорий).
Для этого необходимо указать параметр "page". Таким образом, при указании "page"=1 — будут подгружены первые 1000 категорий, при указании "page"=2 — будут подгружены следующие 1000 категорий и так далее..
Пример запроса:
GET
https://posuda18.ru/api?method=categories&id_user=IDUSER&key_user=KEYUSER&page=1
1 — номер страницы.
Если необходимо получить на одной странице определенное количество категорий, например 10, для этого используйте параметр "limit". Таким образом, при указании "limit"=10 — будет подгружено 10 категорий.
Пример запроса:
GET
https://posuda18.ru/api?method=categories&id_user=IDUSER&key_user=KEYUSER&limit=10
10 — количество подгружаемых категорий на странице.
Можно использовать параметр "page" и "limit" в одном запросе. Благодаря этому произойдет порциональная подгрузка.
Пример запроса:
GET
https://posuda18.ru/api?method=categories&id_user=IDUSER&key_user=KEYUSER&page=2&limit=10
В ответе будет подгружено 10 категорий, начиная с 11-й по ее id.
Для получения категории по id, используйте параметр "id".
Пример запроса:
GET
https://posuda18.ru/api?method=categories&id_user=IDUSER&key_user=KEYUSER&id=7b27762a-5e44-11e6-846b-0018f3868359
В ответе будет подгружена единственная категория с указанным в запросе id (7b27762a-5e44-11e6-846b-0018f3868359).
Данным параметром возможно получить только 1 категорию.
Пример успешного ответа (тело):
JSON
{
"status": true,
"all_categories": 255,
"loaded_categories": 3,
"categories": {
"1": {
"id": "7b27762a-5e44-11e6-846b-0018f3868359",
"name": "Посуда"
},
"2": {
"id": "d7ff8e3c-5fef-11e6-8cf3-0018f3868359",
"name": "Пикник",
"roditel_category": {
"id": "900c593f-1d83-11ea-baa5-0018f3868359",
"name": "Хозяйственные товары"
}
},
"3": {
"id": "d7ff8e40-5fef-11e6-8cf3-0018f3868359",
"name": "Наборы для пикника",
"roditel_category": {
"id": "d7ff8e3c-5fef-11e6-8cf3-0018f3868359",
"name": "Пикник",
"roditel_category": {
"id": "900c593f-1d83-11ea-baa5-0018f3868359",
"name": "Хозяйственные товары"
}
}
},
...
}
}
Описание полей
status — Статус (true — запрос выполнен успешно, false — ошибка при выполнении запроса)
all_categories — Общее количество активных категорий
loaded_categories — Подгруженное количество категорий
categories — Категории
id — Уникальный номер
name — Наименование
roditel_category — Родительская категория
Обратите внимание! Тело ответа на 1 запрос может содержать в себе максимум 1000 населенных пунктов на 1 странице.
Сделано это ограничение для того, чтобы населенные пункты могли своевременно и корректно подгружаться.
Рекомендуем за 1 запрос получать до 500 населенных пунктов. Среднее время подгрузки 1000 населенных пунктов — до 5 секунд.
Для получения активных населенных пунктов (в возрастающем порядке), необходимо выполнить следующий GET запрос:
Пример запроса:
GET
https://posuda18.ru/api?method=city&id_user=IDUSER&key_user=KEYUSER
IDUSER и KEYUSER — необходимо заменить на Ваши значения.
В ответе будет получено до 1000 населенных пунктов, начиная с первого по его id.
Чтобы подгрузить населенные пункты в убывающем порядке, используйте параметр "filter"=desc.
Если не использовать данный параметр, тогда населенные пункты будут подгружаться в возрастающем порядке.
Пример запроса:
GET
https://posuda18.ru/api?method=city&id_user=IDUSER&key_user=KEYUSER&filter=desc
В ответе будет получено до 1000 населенных пунктов, начиная с последнего по его id.
Также есть возможность порционной подгрузки данных (получение более 1000 населенных пунктов).
Для этого необходимо указать параметр "page". Таким образом, при указании "page"=1 — будут подгружены первые 1000 населенных пунктов, при указании "page"=2 — будут подгружены следующие 1000 населенных пунктов и так далее..
Пример запроса:
GET
https://posuda18.ru/api?method=city&id_user=IDUSER&key_user=KEYUSER&page=1
1 — номер страницы.
Если необходимо получить на одной странице определенное количество населенных пунктов, например 10, для этого используйте параметр "limit". Таким образом, при указании "limit"=10 — будет подгружено 10 населенных пунктов.
Пример запроса:
GET
https://posuda18.ru/api?method=city&id_user=IDUSER&key_user=KEYUSER&limit=10
10 — количество подгружаемых населенных пунктов на странице.
Можно использовать параметр "page" и "limit" в одном запросе. Благодаря этому произойдет порциональная подгрузка.
Пример запроса:
GET
https://posuda18.ru/api?method=city&id_user=IDUSER&key_user=KEYUSER&page=2&limit=10
В ответе будет подгружено 10 населенных пунктов, начиная с 11-го по его id.
Для получения населенных пунктов по id, используйте параметр "id".
Пример запроса:
GET
https://posuda18.ru/api?method=city&id_user=IDUSER&key_user=KEYUSER&id=1800900000100
В ответе будет подгружен единственный населенный пункт с указанным в запросе id (1800900000100).
Данным параметром возможно получить только 1 населенный пункт.
Пример успешного ответа (тело):
JSON
{
"status": true,
"all_city": 186837,
"loaded_city": 1,
"city": {
"1800900000100": {
"id": "1800900000100",
"name": "Завьялово",
"type": "с",
"region": "Удмуртская Респ",
"area": "Завьяловский р-н"
},
...
}
}
Описание полей
status — Статус (true — запрос выполнен успешно, false — ошибка при выполнении запроса)
all_city — Общее количество активных населенных пунктов
loaded_city — Подгруженное количество населенных пунктов
city — Список населенных пунктов
id — Уникальный номер
name — Наименование
type — Тип
region — Регион
area — Район
Личный кабинет
Обратите внимание! Тело ответа на 1 запрос может содержать в себе максимум 1000 заказов на 1 странице.
Сделано это ограничение для того, чтобы заказы могли своевременно и корректно подгружаться.
Рекомендуем за 1 запрос получать до 500 заказов. Среднее время подгрузки 1000 заказов — до 5 секунд.
Для получения заказов (в возрастающем порядке), необходимо выполнить следующий GET запрос:
Пример запроса:
GET
https://posuda18.ru/api?method=orders&id_user=IDUSER&key_user=KEYUSER
IDUSER и KEYUSER — необходимо заменить на Ваши значения.
В ответе будет получено до 1000 заказов, начиная с первого по его id.
Чтобы подгрузить заказы в убывающем порядке, используйте параметр "filter"=desc.
Если не использовать данный параметр, тогда заказы будут подгружаться в возрастающем порядке.
Пример запроса:
GET
https://posuda18.ru/api?method=orders&id_user=IDUSER&key_user=KEYUSER&filter=desc
В ответе будет получено до 1000 заказов, начиная с последнего по его id.
Также есть возможность порционной подгрузки данных (получение более 1000 заказов).
Для этого необходимо указать параметр "page". Таким образом, при указании "page"=1 — будут подгружены первые 1000 заказов, при указании "page"=2 — будут подгружены следующие 1000 заказов и так далее..
Пример запроса:
GET
https://posuda18.ru/api?method=orders&id_user=IDUSER&key_user=KEYUSER&page=1
1 — номер страницы.
Если необходимо получить на одной странице определенное количество заказов, например 10, для этого используйте параметр "limit". Таким образом, при указании "limit"=10 — будет подгружено 10 заказов.
Пример запроса:
GET
https://posuda18.ru/api?method=orders&id_user=IDUSER&key_user=KEYUSER&limit=10
10 — количество подгружаемых заказов на странице.
Можно использовать параметр "page" и "limit" в одном запросе. Благодаря этому произойдет порциональная подгрузка.
Пример запроса:
GET
https://posuda18.ru/api?method=orders&id_user=IDUSER&key_user=KEYUSER&page=2&limit=10
В ответе будет подгружено 10 заказов, начиная с 11-го по его id.
Для получения заказов по id, используйте параметр "id".
Пример запроса:
GET
https://posuda18.ru/api?method=orders&id_user=IDUSER&key_user=KEYUSER&id=565
В ответе будет подгружен единственный заказ с указанным в запросе id (565).
Данным параметром возможно получить только 1 заказ.
Пример успешного ответа (тело):
JSON
{
"status": true,
"all_orders": 31,
"loaded_orders": 1,
"orders": {
"568": {
"id": 568,
"date": 1640186115,
"profil": 124,
"organization": 0,
"delivery": "Самовывоз",
"pay": "При получении",
"stat": "Новый",
"sum": "364",
"currency": "RUB",
"comment": "Test",
"api": "0",
"goods": {
"20006": {
"id": 20006,
"url": "https://posuda18.ru/market/good/20006-hlebnica-mini-slonov-kost-up6-pc/",
"article": "Х1501СК",
"name": "Хлебница МИНИ Слонова кость /уп6/ ПЦ",
"price": "144.60",
"count": 1
},
"28501": {
"id": 28501,
"url": "https://posuda18.ru/market/good/28501-lopata-shtykovaya-relsovaya-stal-1-8mm/",
"article": "11094",
"name": "Лопата Штыковая Рельсовая сталь 1,8мм / Россия",
"price": "219.20",
"count": 1
}
}
},
...
}
}
Описание полей
status — Статус (true — запрос выполнен успешно, false — ошибка при выполнении запроса)
all_goodss — Общее количество активных заказов
loaded_goods — Подгруженное количество заказов
goods — Заказы
id — Уникальный номер
date — Дата (Формат unixtime)
profil — Уникальный номер прифиля
organization — Уникальный номер организации
delivery — Способ доставки
pay — Способ оплаты
stat — Статус
sum — Сумма
currency — Валюта
comment — Комментарий
api — Способ создания заказа (0 — через профиль. 1 — через API)
goods — Список товаров
url — Ссылка на товар
article — Артикул
name — Наименование
price — Цена
count — Количество
Обратите внимание! Тело 1 заказа может содержать в себе максимум 1000 товаров (в массиве goods).
Сделано это ограничение для того, чтобы запросы подгружались своевременно и корректно.
Для создания нового заказа, необходимо отправить POST запрос на url:
POST
https://posuda18.ru/api?method=orders
Пример POST запроса (тело):
JSON
{
"iduser": "IDUSER",
"apikey": "APIKEY",
"delivery": "2",
"pay": "3",
"address": "124",
"comment": "Мой новый заказ",
"goods": [
{
"articul": "М1281",
"count": "7",
},
...
]
}
При выполнении даннного запроса, будет создан новый заказ с товаром М1281 (артикул) в количестве 7 шт., с доставкой по адресу, который сохранен под id 124 (получить id можно методом address), а также с оплатой "В магазине".
Описание полей
iduser — Ваше уникальное значение
apikey — Ваше уникальное значение
delivery — Доставка (1 — самовывоз. 2 — доставка)
pay — Оплата (1 — по счету. 2 — при получении. 3 — в магазине)
address — Адрес доставки. Можно получить список адресов доставки методом address. Если не указать данный параметр — будет задействован Ваш адрес доставки, который сохранен как актуальный. Работает только если delivery — 2
comment — Комментарий (необязательно)
goods — Массив с товарами
articul — Артикул товара
count — Количество товаров (не более 100)
Пример успешного ответа (тело):
JSON
{
"status": true,
"error": null,
"text": "Запрос выполнен успешно"
}
Обратите внимание! Тело ответа на 1 запрос может содержать в себе максимум 1000 адресов на 1 странице.
Сделано это ограничение для того, чтобы адреса могли своевременно и корректно подгружаться.
Рекомендуем за 1 запрос получать до 500 адресов. Среднее время подгрузки 1000 адресов — до 5 секунд.
Для получения адресов (в возрастающем порядке), необходимо выполнить следующий GET запрос:
Пример запроса:
GET
https://posuda18.ru/api?method=address&id_user=IDUSER&key_user=KEYUSER
IDUSER и KEYUSER — необходимо заменить на Ваши значения.
В ответе будет получено до 1000 адресов, начиная с первого по его id.
Чтобы подгрузить адреса в убывающем порядке, используйте параметр "filter"=desc.
Если не использовать данный параметр, тогда адреса будут подгружаться в возрастающем порядке.
Пример запроса:
GET
https://posuda18.ru/api?method=address&id_user=IDUSER&key_user=KEYUSER&filter=desc
В ответе будет получено до 1000 адресов, начиная с последнего по его id.
Также есть возможность порционной подгрузки данных (получение более 1000 адресов).
Для этого необходимо указать параметр "page". Таким образом, при указании "page"=1 — будут подгружены первые 1000 адресов, при указании "page"=2 — будут подгружены следующие 1000 адресов и так далее..
Пример запроса:
GET
https://posuda18.ru/api?method=address&id_user=IDUSER&key_user=KEYUSER&page=1
1 — номер страницы.
Если необходимо получить на одной странице определенное количество адресов, например 10, для этого используйте параметр "limit". Таким образом, при указании "limit"=10 — будет подгружено 10 заказов.
Пример запроса:
GET
https://posuda18.ru/api?method=address&id_user=IDUSER&key_user=KEYUSER&limit=10
10 — количество подгружаемых адресов на странице.
Можно использовать параметр "page" и "limit" в одном запросе. Благодаря этому произойдет порциональная подгрузка.
Пример запроса:
GET
https://posuda18.ru/api?method=address&id_user=IDUSER&key_user=KEYUSER&page=2&limit=10
В ответе будет подгружено 10 адресов, начиная с 11-го по его id.
Для получения адресов по id, используйте параметр "id".
Пример запроса:
GET
https://posuda18.ru/api?method=address&id_user=IDUSER&key_user=KEYUSER&id=124
В ответе будет подгружен единственный адрес доставки с указанным в запросе id (124).
Данным параметром возможно получить только 1 адрес.
Пример успешного ответа (тело):
JSON
{
"status": true,
"all_address": 3,
"loaded_address": 1,
"address": {
"124": {
"id": 124,
"date": 1640089356,
"actual": 1,
"name": "Иванов",
"lastname": "Иван",
"firstname": "Иванович",
"phone": "426065",
"index": "+79120123456",
"city": "г.Ижевск (Удмуртская Респ)",
"city_code": "1800000100000",
"street": "Петрова",
"house": "33",
"flat": "777",
"comment": "Моя квартира"
},
...
}
}
Описание полей
status — Статус (true — запрос выполнен успешно, false — ошибка при выполнении запроса)
all_address — Общее количество активных адресов
loaded_address — Подгруженное количество адресов
address — Адреса
id — Уникальный номер
date — Дата (Формат unixtime)
actual — Актуальность (0 — неактуальный. 1 — актуальный)
name — Имя
lastname — Фамилия
firstname — Отчество
phone — Номер телефона
index — Индекс
city — Населенный пункт
city_code — id населенного пункта в базе данных (для поиска определенного, используя метод city)
street — Улица
house — Дом
flat — Квартира / Офис
comment — Комментарий
Прочее
Описание полей
status — Статус (При ошибке в запросе вернется — false. При успешном запросе вернется — true)
error — Номер ошибки (При успешном запросе вернется — null)
text — Ответ (Текст ошибки. При успешном запросе вернется — Запрос выполнен успешно)
Номера ошибок
#1 — Неверный метод
#2 — Отсутсвует IDUSER
#3 — Неверный IDUSER
#4 — Отсутсвует APIKEY
#5 — Неверный APIKEY
#6 — Неверный запрос