GET /people/{personId}/avatar
基本信息
Note: 该端点在Alfresco 5.2.2和更高版本中可用。
获取与people personId相关的头像图像。 如果此people没有相关的头像,则可以选择使用占位符查询参数来请求返回占位符图像。
您可以使用-me-
字符串代替<personid>
来代表当前通过身份验证的用户。
请求方式 :GET
请求API: / people / {personId} / avatar
Query参数
名称 | 类型 | 是否必填 | 示例值 | 描述 |
attachment | boolean | 否 | true (default) | true允许Web浏览器将文件下载为附件。 false表示Web浏览器可以在新标签页或窗口中预览文件,但不能下载文件。 如果文件的内容类型在受支持的列表中,则只能将此参数设置为false;否则,您可以将其设置为false。 例如某些图像文件和PDF文件。 如果预览不支持内容类型,则将忽略false值,并将在响应中返回附件。 |
placeholder | boolean | 否 | true (default) | 如果为true,并且此personId没有头像,则返回占位符图像,而不是404响应。 |
Path参数
名称 | 类型 | 是否必填 | 示例值 | 描述 |
personId | string | 是 | people的标识符。 |
Header参数
名称 | 类型 | 是否必填 | 示例值 | 描述 |
If-Modified-Since | date-time | 否 | 仅在提供日期之后对其进行过修改的内容才返回。 使用HTTP定义的日期格式。 例如,Wed, 09 Mar 2016 16:56:34 GMT . |
错误信息描述
状态码 | 原因 |
200 | 成功回应 |
304 | 自If-Modified-Since标头中提供的日期以来,内容尚未被修改 |
400 | 无效的参数:personId不是有效的格式 |
401 | 验证失败 |
404 | personId不存在或头像不存在(并且不请求占位符) |
default | 意外错误 |
返回结果示例
{ "error": { "errorKey": "string", "statusCode": 0, "briefSummary": "string", "stackTrace": "string", "descriptionURL": "string", "logId": "string" } }