Hướng dẫn test#
Môi trường#
Unicloud eKYC cung cấp API trên giao thức HTTP, với dữ liệu trao đổi ở dạng JSON. Gốc URL:
Môi trường phát triển (dev): https://api-uat.unicloud.ai/ekyc/
Môi trường chạy thật (prod): https://api.unicloud.ai/ekyc/
Để cho gọn, các đầu URL dưới đây sẽ chỉ kể từ sau gốc trở đi, ví dụ API có URL https://api-uat.unicloud.ai/ekyc/files thì tài liệu cụ thể dưới đây chỉ nhắc gọn là "/files".
Công cụ hỗ trợ#
HTTPie và Jo#
HTTPie: Tạo và gửi request HTTP (tương tự cURL nhưng với cú pháp ngắn gọn, ít tính năng hơn để tập trung vào RESTful).
pip install httpie
jo: Sinh ra chuỗi JSON từ các cặp key=value ngắn gọn (không cần gõ dấu ngoặc kép).
git clone https://github.com/jpmens/jo.git
cd jo
autoreconf -i
./configure
make check
make install
Để tránh lộ thông tin org_id:api_key, các dòng lệnh dưới đây truy cập nó qua biến môi trường MY_AUTH. Bạn cần đặt biến môi trường này trước khi làm theo ví dụ.
export MY_AUTH=org_id:api_key
Truyền vào HTTPie:
http -a $MY_AUTH https://api-uat.unicloud.ai/ekyc/kyc-documents
cURL#
Nếu sử dụng cURL, một vài API sẽ cần chuyển đổi file sang base64 trước.
Postman#
Không có mẫu sử dụng Postman