Работа с контактами

Создание контакта пользователя

URL запроса:
POST https://api.catapulto.ru/api/v1/users/contact/create/

Параметры запроса:

Пример запроса

POST /api/v1/users/contact/create/ HTTP/1.1
Host: https://api.catapulto.ru
X-Token: "6c523bd79898gd706c32a05aff13003dc07737e0"
Content-Type: application/json

{
  "address_line_1": "ул Строителей",
  "address_line_2": "",
  "locality_id": "3611199",
  "zip": "103070",
  "building": "15",
  "comment": "Новый клиент Catapulto, офис 12",
  "company": "Catapulto",
  "iso": "RU",
  "name": "Вася Пупкин",
  "phone": "+7 (495) 555-22-41",
  "street": "ул Строителей",
}

Содержание ответа

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

{
  "id": 2088703, 
  "locality": { 
    "id": 3611199, 
    "iso": "RU", 
    "region1": "Москва", 
    "region1_type": "г", 
    "region2": "", 
    "region2_type": "", 
    "region3": "", 
    "region3_type": "", 
    "locality": "Москва", 
    "aoid": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5", 
    "slug": "moskva"
  }, 
  "zip": "103070", 
  "street": "ул Строителей", 
  "street_type": "", 
  "building": "15", 
  "door_number": "", 
  "comment": "Новый клиент Catapulto, офис 12", 
  "company": "Catapulto", 
  "name": "Вася Пупкин", 
  "phone": "+74955552241", 
  "usergroup": { 
    "id": 31810, 
    "title": "Основной отдел"
  }, 
  "address_line_1": "ул Строителей", 
  "address_line_2": ""
}

Редактирование существующего контакта пользователя

URL запроса:
POST https://api.catapulto.ru/api/v1/users/contact/update/

Параметры запроса:

Пример запроса

POST /api/v1/users/contact/update/ HTTP/1.1
Host: https://api.catapulto.ru
X-Token: "6c523bd79898gd706c32a05aff13003dc07737e0"
Content-Type: application/json

{
  "address_line_1": "ул Строителей",
  "address_line_2": "",
  "locality_id": "3611199",
  "zip": "103070",
  "building": "15",
  "comment": "Новый клиент Catapulto, офис 12",
  "company": "Catapulto",
  "iso": "RU",
  "name": "Вася Пупкин",
  "phone": "+7 (495) 555-22-41",
  "street": "ул Строителей",
}

Получение списка контактов пользователя:

URL запроса:
GET https://api.catapulto.ru/api/v1/users/contact/list/

Параметры запроса:

Пример запроса

GET /api/v1/users/contact/list?limit=25 HTTP/1.1
Host: https://api.catapulto.ru
X-Token: "6c523bd79898gd706c32a05aff13003dc07737e0"
Accept: application/json

Содержание ответа

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

{
  "count": 1, 
  "next": "http://api.catapulto.ru/api/v1/users/contact/list/?limit=25", 
  "previous": null, 
  "results": [
    {
      "id": 11970944, 
      "locality": {
        "id": 3615178, 
        "iso": "RU", 
        "region1": "Орловская", 
        "region1_type": "обл", 
        "region2": "", 
        "region2_type": "", 
        "region3": "", 
        "region3_type": "", 
        "locality": "Орел", 
        "aoid": "2abed4d9-5565-4885-bc96-f4ffccc6cba4", 
        "slug": "orel", 
        "utc_offset": 3
      }, 
      "zip": "302042", 
      "street": "Тест", 
      "street_type": "ш", 
      "building": "4", 
      "door_number": "", 
      "comment": "", 
      "company": "Тестовая компания", 
      "name": "Менеджер тестовой компании", 
      "phone": "+74955445000", 
      "usergroup": { 
        "id": 43434, 
        "title": "Тестовый отдел"
      }, 
      "is_favorite": false, 
      "show_in_book": true, 
      "address_line_1": "302042, Орловская обл, Орел, Кромское ш, 4",
      "address_line_2": "", 
      "has_permissions": true, 
      "latitude": 52.9216, 
      "longitude": 36.01045, 
      "phone2": "", 
      "phone_extension": null, 
      "phone2_extension": null, 
      "inn": "", 
      "kpp": null, 
      "country": "RU", 
      "is_valid_contact": true
    }
  ]
}

Получение информации о городе

Request URL:
GET https://api.catapulto.ru/api/v1/geo/locality/search/

Параметры запроса:

Пример запроса

GET /api/v1/geo/locality/search?term=Москва&iso=RU HTTP/1.1
Host: https://api.catapulto.ru
Accept: application/json

Содержание ответа

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

[
  {
    "id": "3611199", 
    "region1": null,
    "region1_type": "г", 
    "region2": "", 
    "region2_type": "", 
    "region3": "", 
    "locality": "Москва", 
    "zip": "103070", 
    "aoid": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5", 
    "shortname": "г", 
    "slug": "moskva", 
    "utc_offset": "3", 
    "iso": null
  },
  {
    ...
  }
]