Примеры

Партнёры

Список

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