API

Base FindFace API URL

http://webapi.findface.ru/v2

---

Authentication on vk.com

Getting VK_UID and VK_TOKEN

URL https://oauth.vk.com/authorize?client_id=5150352&display=page&redirect_uri=https%3A%2F%2Foauth.vk.com%2Fblank.html&scope=friends%2Cmessages%2Cemail%2Cphotos%2Cwall%2Cnotify%2Cnotifications%2Coffline&response_type=token&v=5.50

---

Authentication on server

POST 
/user/new

Params:

Key	Value
uid	VK_UID
token	VK_TOKEN

Response:

#!json

{
  "success": "yes",
  "user_id": 115
}

---

User info

GET 
/user-info/list

Header:

Key	Value
Authorization	Bearer VK_TOKEN

Response:

#!json

{
  "user_id": 115,
  "account_type": 1,
  "subscribe_end_date": "2020-12-31",
  "search_count": 27,
  "search_top": 0,
  "hide_from_search": 0,
  "vk_open_count": 1,
  "email": "no-email@website.ru",
  "invite_hash": "05d232ef021ce241de921ce4fd72a262",
  "invite_count": 0,
  "check_delete_key": "4a4f2cf7fa788968522ddfcdaa2e3e98"
}

---

History

GET 
/search/history

Header:

Key	Value
Authorization	Bearer VK_TOKEN

Params:

Key	Value
uid	VK_UID

Response:

#!json
[
  {
    "user_id": "115",
    "uid": "180431462",
    "detect_photo": "b7bc9a739a6cdd6acdebcf61fd69c934.png",
    "image": "http://img.findface.ru/upload/i/b7bc9a739a6cdd6acdebcf61fd69c656.png",
    "x1": "563",
    "y1": "113",
    "x2": "670",
    "y2": "220",
    "hash": "a27f43d74e9f27e35d6ce4cb923fc879",
    "create_time": "2016-04-22 21:05:05"
  },
  {
    "user_id": "115",
    "uid": "180431462",
    "detect_photo": "23a6a846821ce30d585acad275526a04.png",
    "image": "http://img.findface.ru/upload/i/23a6a846821ce30d585acad27552hgg6.png",
    "x1": "270",
    "y1": "197",
    "x2": "366",
    "y2": "291",
    "hash": "62e89a7b34201b2fe0e0cf03def5251b",
    "create_time": "2016-04-07 00:46:47"
  },
  {
    "user_id": "115",
    "uid": "180431462",
    "detect_photo": "93a70dff66a81392443c61b7232290d5.jpg",
    "image": "http://img.findface.ru/upload/i/93a70dff66a81392443c61b72322d6o0.jpg",
    "x1": "378",
    "y1": "421",
    "x2": "452",
    "y2": "495",
    "hash": "1450307249e5e170512a7cdc51b06818",
    "create_time": "2016-03-25 23:35:22"
  }
]

---

Detect face

POST 
/search/detect

Header:

Key	Value
Authorization	Bearer VK_TOKEN

Params:

Key	Value
user_id	FINDFACE_USER_ID (From example: 115)
image	(MultipartBody)

Response:

#!json

{
  "bboxes": [
    {
      "x1": 563,
      "y1": 113,
      "x2": 670,
      "y2": 220,
      "hash": "a27f43d74e9f27e35d6ce4cb923fc879"
    }
  ],
  "image_hash": "5b60d77b93e49b8.png",
  "md5_image_hash_file": "b7bc9a739a6cdd6acdebcf61fd69c939",
  "detect_photo_url": "http://img.findface.ru/upload/i/b7bc9a739a6cdd6acdebcf61fd69c939.png",
  "uid": "VK_UID",
  "user_id": "115"
}

---

Search

GET 
/search/list3

Header:

Key	Value
Authorization	Bearer VK_TOKEN

Params:

Key	Value
hash	(From example: a27f43d74e9f27e35d6ce4cb923fc879)
image_hash	(From example: 5b60d77b93e49b8.png)
user_id	FINDFACE_USER_ID (From example: 115)
x1	(From example: 563)
y1	(From example: 113)
x2	(From example: 670)
y2	(From example: 220)

Response:

#!json

[
  {
    "user_id": 319124657,
    "photo_id": 381711004,
    "bbox": [
      201,
      370,
      237,
      406
    ],
    "similarity": 0.38884109258652,
    "search_top": 0,
    "hide_from_search": 0
  },
  {
    "user_id": 258122373,
    "photo_id": 379183493,
    "bbox": [
      388,
      79,
      543,
      234
    ],
    "similarity": 0.39214110374451,
    "search_top": 0,
    "hide_from_search": 0
  },
  {
    "user_id": 171848995,
    "photo_id": 377976286,
    "bbox": [
      164,
      95,
      254,
      185
    ],
    "similarity": 0.40862262248993,
    "search_top": 0,
    "hide_from_search": 0
  },
  {
    "user_id": 121119034,
    "photo_id": 207946998,
    "bbox": [
      329,
      54,
      436,
      162
    ],
    "similarity": 0.40934002399445,
    "search_top": 0,
    "hide_from_search": 0
  }
]

---

Search from history

POST 
/search/detect

Params:

Key	Value
image_url	(From example: 5b60d77b93e49b8.png)
user_id	FINDFACE_USER_ID (From example: 115)

#!json

{
  "bboxes": [
    {
      "x1": 774,
      "y1": 450,
      "x2": 921,
      "y2": 598,
      "hash": "00c9f0dc34758815a20f222b5a7fa684"
    },
    {
      "x1": 1052,
      "y1": 466,
      "x2": 1200,
      "y2": 614,
      "hash": "2a8e94310f1ea454e039e388325ff952"
    },
    {
      "x1": 1380,
      "y1": 466,
      "x2": 1527,
      "y2": 614,
      "hash": "a25c825a3756d8a2165c03e4e17bdca5"
    },
    {
      "x1": 872,
      "y1": 286,
      "x2": 1019,
      "y2": 434,
      "hash": "40aa47e4b9591dd6f68a5d2f9a25cd3f"
    }
  ],
  "image_hash": "0e942c4e9c7cdfg.png",
  "md5_image_hash_file": "74a79d036effc6b927e19d93fae147fg",
  "detect_photo_url": "http://img.findface.ru/upload/i/74a79d036effc6b927e19d93fae147fg.png",
  "uid": "180431462",
  "user_id": "115"
}