Полное описание интеграции с системой dostavka guru по средствам web-сервисов


Получение информации о ПВЗ по его ID



Скачать 387.84 Kb.
страница8/8
Дата31.07.2016
Размер387.84 Kb.
1   2   3   4   5   6   7   8

4.2 Получение информации о ПВЗ по его ID


Получение параметров ПВЗ по его ID по принципу POST запроса, с указанием обязательных переменных.

URL для отправки POST массива:

http://api.dostavka.guru/client/pvz_list.php



Переменные:

Поле

Описание

Формат

partner_id

Уникальный ID в системе dostavka.guru.

Четырехзначный, числовой: 9999

key

Уникальный API ключ в системе dostavka.guru.

Хеш код

script

тип скрипта (all_list - список ПВЗ)

Текстовый

pointID

код ПВЗ

Текстовый

Пример POST массива для отправки:

$_POST = array

(

[partner_id] => 9999

[key] => 827ccb0eea8a706c4c34a16891f84e7b

[script] => all_list

[pointID] => 19

)

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

Ответ сервера такой же, как в пункте 3.3

Обработка ошибок:

Если какие-то поля будут заполнены не правильно, то сервер выдаст сообщение об ошибке. К примеру:



Error: 200 - Ключ API не верен!
и прочие...

4.3 Получение списка городов с ПВЗ


Получение полного списка городов пунктов выдачи по принципу POST запроса, с указанием обязательных переменных.

URL для отправки POST массива:

http://api.dostavka.guru/client/pvz_list.php

Переменные:

Поле

Описание

Формат

partner_id

Уникальный ID в системе dostavka.guru.

Четырехзначный, числовой: 9999

key

Уникальный API ключ в системе dostavka.guru.

Хеш код

script

тип скрипта (all_city - список городов ПВЗ)

Текстовый

Пример POST массива для отправки:

$_POST = array

(

[partner_id] => 9999

[key] => 827ccb0eea8a706c4c34a16891f84e7b

[script] => all_city

)

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




5
Абакан


92
Альметьевск




Обработка ошибок:

Если какие-то поля будут заполнены не правильно, то сервер выдаст сообщение об ошибке. К примеру:



Error: 200 - Ключ API не верен!
и прочие...

4.4 Вставка карты ПВЗ на сайт, как информационная страница


Данный пример позволит вставить карту в информационную страницу сайта для ознакомления клиентов с пунктами выдачи заказов.
Пример работы скрипта можно посмотреть здесь:

http://api.dostavka.guru/client/map_with_but/map_simple.html




Как вставить код карты:

Карта (Вставляется внутри тега "body" в нужном для Вас месте):





Скрипт инициализации карты (первая строчка не нужна, если jQuery уже подключен) (Вставляется внутри тега "head" на нужной для Вас странице):












4.5 Проверка качества адреса


Получение варианта исправления адреса и код точности по принципу POST запроса, с указанием обязательных переменных.

URL для отправки POST массива:

http://api.dostavka.guru/client/check_addr.php

Переменные:

Поле

Описание

Формат

partner_id

Уникальный ID в системе dostavka.guru.

Четырехзначный, числовой: 9999

key

Уникальный API ключ в системе dostavka.guru.

Хеш код

addr

Адрес доставки

Текстовый UTF-8

Пример POST массива для отправки:

$_POST = array

(

[partner_id] => 9999

[key] => 827ccb0eea8a706c4c34a16891f84e7b

[addr] => егорьевск 1-й мкн 35 34

)

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

Ответ сервера будет массив в формате json. Для извлечения массива используйте PHP функцию: $array=json_decode($data, true)

Array

(

[structure] => Array



(

[0] => ADDRESS

)

[data] => Array



(

[0] => Array

(

[0] => Array



(

[source] => егорьевск 1-й мкн 35 34

[result] => Россия, Московская обл, г Егорьевск, мкр 1-й, д 35, кв 34

[postal_code] => 140304

[country] => Россия

[region_type] => обл

[region_type_full] => область

[region] => Московская

[area_type] => р-н

[area_type_full] => район

[area] => Егорьевский

[city_type] => г

[city_type_full] => город

[city] => Егорьевск

[settlement_type] =>

[settlement_type_full] =>

[settlement] =>

[city_district] =>

[street_type] => мкр

[street_type_full] => микрорайон

[street] => 1-й

[house_type] => д

[house_type_full] => дом

[house] => 35

[block_type] =>

[block_type_full] =>

[block] =>

[flat_type] => кв

[flat] => 34

[postal_box] =>

[kladr_id] => 5000700100000010030

[fias_id] => 31158fcd-b058-4b80-a43b-e8dcb3c0057c

[capital_marker] => 1

[okato] => 46212501000

[oktmo] => 46612101001

[tax_office] => 5011

[tax_office_legal] =>

[flat_area] => 32.1

[square_meter_price] =>

[flat_price] =>

[timezone] => UTC+3

[geo_lat] => 55.3738931

[geo_lon] => 39.062796

[qc_geo] => 0

[qc_complete] => 0

[qc_house] => 2

[qc] => 0

[unparsed_parts] =>

)

)

)



)

Где параметр qc - отвечает за точность адреса. Нужно добиваться, чтобы адрес выдавал код точности "0". Все остальные система заявок DOSTAVKA.guru не пропустит.



Описание остальных полей:

Название

Длина

Описание

source

250

Исходный адрес одной строкой

result

500

Стандартизованный адрес одной строкой

postal_code

6

Индекс

country

120

Страна

region_type

10

Тип региона (сокращенный)

region_type_full

50

Тип региона

region

120

Регион

area_type

10

Тип района в регионе (сокращенный)

area_type_full

50

Тип района в регионе

area

120

Район в регионе

city_type

10

Тип города (сокращенный)

city_type_full

50

Тип города

city

120

Город

settlement_type

10

Тип населенного пункта (сокращенный)

settlement_type_full

50

Тип населенного пункта

settlement

120

Населенный пункт

city_district

120

Район города

street_type

10

Тип улицы (сокращенный)

street_type_full

50

Тип улицы

street

120

Улица

house_type

10

Тип дома (сокращенный)

house_type_full

50

Тип дома

house

50

Дом

block_type

10

Тип корпуса/строения (сокращенный)

block_type_full

50

Тип корпуса/строения

block

50

Корпус/строение

flat_type

10

Тип квартиры

flat

50

Квартира

flat_area

50

Площадь квартиры

square_meter_price

50

Рыночная стоимость м?

flat_price

50

Рыночная стоимость квартиры

postal_box

50

Абонентский ящик

fias_id

36

Код ФИАС:

HOUSE.HOUSEGUID, если дом найден в ФИАС по точному совпадению;

HOUSEINT.HOUSEGUID, если дом найден в ФИАС как часть интервала;

ADDROBJ.AOGUID в противном случае.



kladr_id

19

Код КЛАДР

capital_marker

1

Является ли город центром:

1 — центр района (Московская обл, Одинцовский р-н, г Одинцово)

2 — центр региона (Новосибирская обл, г Новосибирск);

3 — центр района и региона (Костромская обл, Костромской р-н, г Кострома);



0 — ни то, ни другое (Московская обл, г Балашиха).

okato

11

Код ОКАТО

oktmo

11

Код ОКТМО

tax_office

4

Код ИФНС для физических лиц

tax_office_legal

4

Код ИФНС для организаций (не заполняется)

timezone

10

Часовой пояс

geo_lat

10

Координаты: широта

geo_lon

10

Координаты: долгота

qc_geo

5

Код точности координат

qc_complete

5

Код полноты

qc_house

5

Код проверки дома

qc

5

Код качества

unparsed_parts

250

Нераспознанная часть адреса. Для адреса
Москва, Митинская улица, 40к2с2 кв 12, просил доставку после обеда — утром похмелье
вернем
ПРОСИЛ, ДОСТАВКУ, ПОСЛЕ, ОБЕДА, УТРОМ, ПОХМЕЛЬЕ.






Поделитесь с Вашими друзьями:
1   2   3   4   5   6   7   8


База данных защищена авторским правом ©uverenniy.ru 2019
обратиться к администрации

    Главная страница