Quy trình làm việc của API

Lấy danh sách Gói đấu giá

Gọi LIST API. Hỗ trợ lọc theo external_deal_id

Tạo gói đấu giá mới

1. external_deal_id phải là duy nhất. Gọi LIST bằng external_deal_id để xem mã nhận dạng đã được sử dụng hay chưa.
2. Gọi Tạo API. Một tên duy nhất sẽ được chỉ định và có thể dùng để Lấy gói đã tạo.
3. Gọi Get API để xem thông tin chi tiết về Gói đấu giá đã tạo.
4. Bạn có thể Tải biểu trưng lên cho gói đã tạo.

Cập nhật gói đấu giá

1. Nếu bạn không lưu trữ tên Auction Package đã tạo, hãy gọi bộ lọc LIST API theo external_deal_id để lấy Auction Package mà bạn muốn cập nhật.
2. Cập nhật các trường dựa trên kết quả của LIST API.
3. Gọi Patch API để cập nhật Gói đấu giá. Bạn phải có "updateMask", tham số này cho biết những trường mà bạn muốn áp dụng nội dung cập nhật. Bạn chỉ có thể đặt những trường được phép cập nhật trong "updateMask".

Quy trình thử nghiệm beta

Điểm khác biệt duy nhất giữa phiên bản Beta và phiên bản GA là trong phiên bản beta, các Gói đấu giá được tạo cần phải có trạng thái được đặt thành "DISCOVERY_OBJECT_STATUS_PAUSED" và bạn không thể cập nhật trạng thái. Các gói PAUSED sẽ không xuất hiện trong giao diện người dùng DV3. Mục đích là để các sàn giao dịch có thể kiểm thử hoạt động tích hợp API mà không cần hiển thị các gói kiểm thử.

Thông thường, bạn sẽ tạo tất cả các gói "thực" ở trạng thái DỪNG trong giai đoạn thử nghiệm beta, sau đó "kích hoạt" chúng sau khi phát hành công khai.

Hạn mức

2.000 gói đang hoạt động cho mỗi sàn giao dịch.

2.000 gói bị tạm dừng cho mỗi sàn giao dịch.