Примеры

Партнёры

Список

Получить список партнёров, среди которых можно искать связи с объектами 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
...