Hướng dẫn sử dụng gói API của phần mềm Dauthau.info - vinades/api.dauthau.info GitHub Wiki
Bắt đầu với hệ thống.
Sau khi đọc tài liệu này, bạn có khả năng:
- Truy cập vào hệ thống.
- Cập nhật, theo dõi các role api mà mình đăng ký
Đường dẫn chính thức: https://api.dauthau.asia/login/
Đăng nhập vào hệ thống
- Khi bạn thấy màn hình đăng nhập của hệ thống, bạn hãy nhập Tên đăng nhập (username) vào ô Bí danh, nhập Mật khẩu (password) và ô Mật khẩu và bấm Đăng nhập.
Lưu ý: Tài khoản để đăng nhập là tài khoản mà bạn đã đăng ký gói API PRO tại DauThau.asia.
Quản lý API
-
Sau khi đăng nhập thành công, bạn sẽ được chuyển đến trang Quản lý tài khoản. Hãy bấm vào nút
để vào trang quản lý API.
-
Sau khi được chuyển trang, quý khách sẽ thấy 2 nút
và
, trong đó:
- Các API-role công cộng: Là các API-role mà nhà phát triển mở miễn phí cho mọi người cùng sử dụng.
- Các API-role được chỉ định: Là API-role mà bạn đã được cấp sau khi đăng ký gói API-PRO.
-
Tiếp theo, khi bấm vào Các API-role được chỉ định, hệ thống sẽ hiển thị danh sách API-role như hình bên dưới.
-
Trong đó:
- Danh sách các API-role: Tên API-role
- Các API: Số API được phép truy cập tại role này, khi click vào ta có 1 bảng hiển thị danh sách với tên các API
- Trạng thái API-role: Có thể là Hoạt động hoặc Đình chỉ
- Trạng thái người sử dụng: Thường là Đã kích hoạt
- Bắt đầu: Thời gian bắt đầu được phép gọi API
- Kết thúc: Thời gian kết thúc được phép gọi API
- Hạn ngạch: Chỗ này chỉ số lần được gọi API (thường là Không giới hạn)
- Số lần gọi API-role: Tổng số lần đã gọi API của role này
- Gọi API-role gần đây: Thời điểm gọi API-role gần đây nhất
Sử dụng API-role
-
Bước 1: Khi bấm vào nút
, hệ thống sẽ hiển thị 2 phương thức xác thực, khách hàng có thể tuỳ ý chọn
-
Bước 2.1: Khách hàng click vào
để hệ thống sinh ra mã xác thực, bao gồm Khoá truy cập (API_KEY) và Mã bí mật (API_SECRET)
Lưu ý: Hai mã này quý khách cần giữ bảo mật, tránh để lộ.
- Bước 2.2: Trong trường hợp muốn xoá bỏ mã xác thực, quý khách bấm vào
để hệ thống xoá mã.
- Bước 2.3: Để bảo mật hơn, hệ thống có cấu hình chỉ cho phép gọi API-role ở một số địa chỉ IP nhất định, để kích hoạt tính năng này cần khai báo các địa chỉ IP được cách nhau bởi dấu phẩy
Như vậy, quý khách hàng đã nắm được cách sử dụng các tính năng cơ bản của hệ thống.
Hướng dẫn test API
Quý khách có thể tham khảo 2 cách sau:
Lưu ý: Nếu dùng PHP thì nên sử dụng phương thức xác thực password_verify, còn lại nên dùng md5_verify.
Danh sách các API của gói API-PRO
STT | Tên API | Mô tả | Hoàn thành |
---|---|---|---|
1 | GetDetailKqlcnt | Lấy các thông tin chi tiết của Kqlcnt | 23/02/2023 |
2 | GetDetailTbmt | Lấy các thông tin chi tiết của TBMT | 23/02/2023 |
3 | ListAllKqlcnt | Lấy các thông tin danh sách KQLCNT | 23/02/2023 |
4 | ListAllTbmt | Lấy các thông tin danh sách TBMT | 23/02/2023 |
5 | ListBusinessReg | Kiểm tra xem MST doanh nghiệp có trên hệ thống dauthau.info chưa | 23/02/2023 |
6 | ListCrawsResult | Lấy danh sách KQLCNT mới bóc về | 23/02/2023 |
7 | ListKQLCNT | Lấy các thông tin về KQLCNT của doanh nghiệp có MST nhập vào trúng thầu | 23/02/2023 |
8 | ListResultGoods | Lấy dữ liệu hàng hoá của Kết quả lựa chọn nhà thầu | 23/02/2023 |