Delete

Данный метод позволяет удалить связь между фотографией и person_id.

Запрос

Авторизационные данные передаются в строке запроса:


ПараметрТипЗначение
oauth_tokenstringOAuth2 access token (required non-empty)
oauth_providerstring провайдер OAuth2 (required non-empty)

Поддерживаемые провайдеры OAuth2:


ПровайдерЗначение oauth_providerПолучение токена
Mail.Rumcs

Смотрите в статье

Параметры запроса передаются в формате JSON в теле запроса с name="meta":


ПараметрТипЗначение
space stringчисловой идентификатор, используемый для избежания пересечений по персонам (required non-empty)
images []image_metaметаданные передаваемых изображений (required non-empty)

Параметр space используется для избежания пересечений по person. Таким образом, person1 из space 0 и person1 из space 1 разные. Для приложений, решающих различные задачи, имеет смысл использовать различные значения space.

Клиент может иметь до 10 различных spaceзначения space изменяются от "0" до "9" В случае превышения лимита вернется ошибка.

image_meta

ПараметрТипЗначение
name stringимена файлов для сопоставления файлов в запросе и ответе (required non-empty)
person_id int ID, сопоставляемый персоне на фото (required non-empty)

Изображения передаются в теле запроса, значения поля name должны соответствовать переданным в images. Максимальное количество изображений в одном запросе равняется 100. Максимальный размер каждого изображения не должен превышать 4МБ.

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

POST /api/v1/persons/delete?oauth_provider=mr&oauth_token=123 HTTP/1.1
ConContent-Type: multipart/form-data; boundary=----WebKitFormBoundaryfCqTBHeLZlsicvMp
  
------WebKitFormBoundaryfCqTBHeLZlsicvMp
Content-Disposition: form-data; name="meta"
  
{"space":"0""images":[{"name":"file_0""person_id":1},{"name":"file_1""person_id":2}]}
------WebKitFormBoundaryfCqTBHeLZlsicvMp--


Пример с curl:

curl "http://localhost/api/v1/persons/delete?oauth_provider=mr&oauth_token=123" -F meta='{"images":[{"name":"f1", "person_id":1},{"name":"f2", "person_id":2}], "space":"1"}'

Ответ

ПараметрТипЗначение
status int 200 в случае успеха, иначе описание ошибки будет в body
body string тело ответа

response

ПараметрТипЗначение
objects []object

массив ответов для каждого файла

object

ПараметрТипЗначение
statusenum результат выполнения
error string текстовое описание ошибки (optional)
name string имя файла для сопоставления файлов в запросе и ответе

status

ПараметрЗначение
0успешно
1перманентная ошибка
2временная ошибка

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


{

"status":200,

"body":{

"objects":[

   {

  "status":0,

  "name":"file_0"

   },

   {

   "status":1,

   "name":"file_1",

   "error":"The memory contains data of an unknown image type"

   }

]

},

"htmlencoded":false,

"last_modified":0

}