Trả về hình ảnh có kích thước đầy đủ hoặc hình ảnh được điều chỉnh theo tỷ lệ dựa trên URI. Các tham số đầu vào bao gồm
độ phân giải. Đây là lệnh duy nhất sẽ trả về, Content-Type: image/jpeg
.
Tất cả các lệnh khác trả về Content-Type: application/json;charset=utf-8
.
Lệnh này không còn được dùng trong API cấp 2.
Tham số
- fileUri: URI của tệp đích. Các nhà sản xuất quyết định có nên sử dụng URI tuyệt đối hoặc tương đối. Ứng dụng có thể coi đây là giá trị nhận dạng không rõ ràng.
- maxSize: (Không bắt buộc) Kích thước tối đa của hình ảnh được yêu cầu;
max(scaledimage_width, chiều_cao_hình_ảnh_tỷ_lệ). Nếu
maxSize
bị bỏ qua hoặc lớn hơn hình ảnh kích thước đầy đủ sẽ được trả về.
Kết quả
- content: Dữ liệu nhị phân của hình ảnh, bao gồm cả dữ liệu tương ứng (ví dụ: được điều chỉnh theo tỷ lệ) siêu dữ liệu trong tiêu đề hình ảnh.
Lỗi
- missingTham số:
fileUri
bắt buộc chưa được chỉ định. - không hợp lệ Tham số: Tên tham số đầu vào không nhận dạng được.
- invalidParameterValue: Tên thông số đầu vào được nhận dạng, nhưng giá trị của tham số đó
không hợp lệ; ví dụ: giá trị
fileUri
không tồn tại, loại dữ liệu của giá trị không chính xác, hoặcmaxSize
có loại dữ liệu không chính xác.
Lệnh I/O | |
---|---|
Nhập lệnh | { "parameters": { "fileUri": "file URI", "maxSize": 400 } } |
Kết quả lệnh | Image binary data |
Ra lệnh (Lỗi) | { "error": { "code": "invalidParameterValue", "message": "Parameter fileUri doesn't exist." } } |