Tải ảnh xuống

Truy xuất một ảnh đã tải lên trước đó theo image_id của nó. Response body là ảnh thô, không phải JSON.

Endpoint

POST /v1/images/<image_id>
Content-Type: application/json

Tham số:

Tham số	Kiểu	Bắt buộc	Mặc định	Mô tả
image_id	string	Có	—	ID duy nhất của ảnh, được cung cấp dưới dạng một path segment.

Trả về: body dạng binary image/jpeg

Ví dụ request

curl -X POST \
  '<BASE_URL>/v1/images/8dd701de-8c61-4b9b-9cc1-67553e9cbd5b' \
  -H 'Authorization: ATV <ACCESS_ID>:<SIGNATURE>' \
  -H 'X-TV-Timestamp: <TIMESTAMP>' \
  -H 'Content-Type: application/json' \
  --data ''

Response

Khi thành công, Content-Type của response là image/jpeg và body chính là ảnh. Khi thất bại, response là JSON:

{
  "errors": [],
  "success": false,
  "code": 0,
  "message": "string"
}

Trường	Kiểu	Mô tả
errors	array	Chi tiết lý do việc tải xuống thất bại.
success	bool	false khi ảnh không thể trả về được.
code	int	status code dạng số.
message	string	Thông báo trạng thái.

WARNING

Các ảnh tải xuống là giấy tờ tùy thân và dữ liệu sinh trắc học của khách hàng. Chỉ phục vụ chúng cho các bên gọi nội bộ đã được xác thực, không bao giờ proxy endpoint này cho một client công khai, và áp dụng chính sách lưu giữ dữ liệu của riêng bạn cho bất kỳ bản sao nào bạn lưu trữ.

Lỗi

Mã	Thông báo
2001010	Không tìm thấy Access ID.
2001014	Vượt giới hạn tốc độ đăng ký.
2001015	Vượt giới hạn brute-force khi đăng ký.
401100	Bạn không được phép thực hiện hành động này.
4001000	Tham số đầu vào vi phạm một ràng buộc.
4001001	Header X-TV-Timestamp đã hết hạn, cần một cái mới hơn.
5001000	Xảy ra lỗi không mong đợi trong quá trình xử lý request.

Bước tiếp theo

• Tải ảnh lên — cách một image_id được tạo ra ngay từ đầu