Просмотреть исходный

Метод: POST

Ресурс: person/images

Параметры (передаются в виде JSON):

response_type — тип ответа:
- chunked — используется Transfer-Encoding: chunked , где каждое изображение отдаётся в своём блоке и в порядке, переданном в теле запроса, если изображения нет, то вместо изображения передаётся null символ "\0"
- multipart/mixed — используется формат multipart/mixed ^rfc tech-ms, он не входит в стандарт HTTP, но используется в электронных письмах. Поэтому реализовать его не составляет труда. Так же он очень похож на multipart/form-data . Каждое изображение отдаётся в своём блоке и помечено отдельно заголовком X-Person-ID, к какой персоне оно принадлежит. Если изображения нет, то оно либо не передаётся, либо тело этого изображения отсутствует
person_id — массив ID персон

Примеры:

chunked :

Запрос

POST /xapi/person/images
X-API-Version: 1
X-API-CompanyId: iw
X-API-ImporterName: dome
X-API-Auth-Token: brse99dugp1cdbr69axz
(пустая строка)
{"response_type": "chunked", "person_id": ["DEF1CC1FA015CA428D5DE3CD5B804B69", "E277B624BC988C4C96590A8435F634ED"]}

Ответ

HTTP/1.1 200 OK
Content-Type: image/png
Transfer-Encoding: chunked
(пустая строка)
1
\0 (символ отсутствия изображения для персоны DEF1CC1FA015CA428D5DE3CD5B804B69)
48AC
(содержимое изображения для персоны E277B624BC988C4C96590A8435F634ED)
0

multipart/mixed :

Запрос

POST /xapi/person/images
X-API-Version: 1
X-API-CompanyId: iw
X-API-ImporterName: dome
X-API-Auth-Token: brse99dugp1cdbr69axz
(пустая строка)
{"response_type": "multipart/mixed", "person_id": ["DEF1CC1FA015CA428D5DE3CD5B804B69", "E277B624BC988C4C96590A8435F634ED"]}

Ответ

HTTP/1.1 200 OK
Content-Type: multipart/mixed; boundary=Asrf456BGe4h
Content-Length: (суммарный объём, включая дочерние заголовки, может отсутствовать!)
(пустая строка)
(отсутствующая преамбула)
--Asrf456BGe4h
Content-Type: application/x-empty
Content-Disposition: attachment; filename="DEF1CC1FA015CA428D5DE3CD5B804B69"
X-Person-ID: DEF1CC1FA015CA428D5DE3CD5B804B69
(пустая строка и после нулевое содержимое)
--Asrf456BGe4h
Content-Disposition: attachment; filename="E277B624BC988C4C96590A8435F634ED.jpg"
Content-Type: image/jpeg
X-Person-ID: E277B624BC988C4C96590A8435F634ED
(пустая строка)
(двоичное содержимое второй персоны E277B624BC988C4C96590A8435F634ED)
--Asrf456BGe4h--
(отсутствующий эпилог - пустая строка)