Примеры
Партнёры
Список
Получить список партнёров, среди которых можно искать связи с объектами 2ГИС.
https://twins.api.2gis.com/v1/partners?key=APIKEY
В результате отображаются только партнёры, доступные для переданного ключа.
{
"meta": {
"code": 200,
"message": "ok"
},
"result": {
"items": [
{
"code": "sber-food",
"name": "SberFood"
},
{
"code": "sber-ryadom",
"name": "СберРядом"
}
],
"total": 2
}
}
Связи
Объекты 2ГИС
По идентификаторам объектов 2ГИС получить объекты партнёров.
https://twins.api.2gis.com/v1/twins/search/dgis?dgis_id=2674540563776880&dgis_id=1267165676509882&partner_code=sber-food&partner_code=sber-ryadom&key=APIKEY
Связь один к одному не гарантируется, объект в другой системе может отсутствовать либо состоять из нескольких.
{
"meta": {
"code": 200,
"message": "ok"
},
"result": {
"items": [
{
"dgis_id": "1267165676509882",
"dgis_type": "branch",
"twins": [
{
"partner_id": "21934",
"partner_type": "branch",
"partner_code": "sber-food"
},
{
"partner_id": "21939",
"partner_type": "branch",
"partner_code": "sber-food"
}
]
},
{
"dgis_id": "2674540563776880",
"dgis_type": "branch",
"twins": [
{
"partner_id": "22842",
"partner_type": "branch",
"partner_code": "sber-food"
},
{
"partner_id": "23984",
"partner_type": "branch",
"partner_code": "sber-food"
},
{
"partner_id": "140000002450",
"partner_type": "branch",
"partner_code": "sber-ryadom"
}
]
}
],
"total": 2
}
}
Объекты партнёров
По идентификаторам объектов партнёра получить объекты 2ГИС.
https://twins.api.2gis.com/v1/twins/search/partners?partner_id=21934&partner_id=22842&partner_code=sber-food&key=APIKEY
Связь один к одному не гарантируется, объект в 2ГИС может отсутствовать либо состоять из нескольких.
{
"meta": {
"code": 200,
"message": "ok"
},
"result": {
"items": [
{
"partner_id": "22842",
"partner_type": "branch",
"twins": [
{
"dgis_id": "2674540563776880",
"dgis_type": "branch"
}
]
},
{
"partner_id": "21934",
"partner_type": "branch",
"twins": [
{
"dgis_id": "1267165676509882",
"dgis_type": "branch"
},
{
"dgis_id": "70000001022214983",
"dgis_type": "branch"
}
]
}
],
"total": 2
}
}
Все связи
Получить все связи объектов 2ГИС и партнёра.
https://twins.api.2gis.com/v1/twins/export?partner_code=sber-food&key=APIKEY
Формат ответа CSV.
dgis_id,dgis_type,partner_id,partner_type
1267165676509882,branch,21934,branch
1267165676509882,branch,21939,branch
2674540563776880,branch,22842,branch
...