Fastvalue Docs
1.0.0

Tài liệu API Fastvalue

Đây là tài liệu API chính thức của Nền tảng Fastvalue, dành cho đội ngũ kỹ thuật và Quý Khách hàng được cấp quyền. Tài liệu này hướng dẫn quy trình tích hợp, cơ chế xác thực và các quy ước quan trọng. Đồng thời, tài liệu nhấn mạnh trách nhiệm bảo mật khi sử dụng API của các bên liên quan.

Bắt đầu tích hợp Hướng dẫn tích hợp

Môi trường

Production

v1.0.0

API Chính thức

https://developer.fastvalue.vn/collateralvalue-service/v1

Staging

v1.0.0

Môi trường thử nghiệm

https://developer-staging.fastvalue.vn/collateralvalue-service/v1

Bảo mật & Xác thực

Bearer Token (JWT)

Authorization: Bearer <token>

Sử dụng API POST /get-credentials với Client ID/Secret và email/password của bạn để lấy Token. Sau đó gửi Token này trong header Authorization.

Quy ước dữ liệu

  • JSON
    UTF-8

    Định dạng chuẩn cho request/response

  • Date
    ISO 8601

    Ví dụ: 2026-01-19T08:00:00Z

  • Case
    snake_case

    Sử dụng cho tên trường (VD: user_id)

  • Timeout
    5s

    Thời gian chờ tối đa 5s cho mọi request

  • Retry
    3x

    Tự động retry tối đa 3 lần nếu lỗi kết nối

HTTP Status Codes

CodeMeaning
200Thành công
201Tạo mới thành công
400Lỗi dữ liệu đầu vào
401Chưa xác thực (Thiếu token)
403Không có quyền truy cập
422Lỗi validation dữ liệu
500Lỗi hệ thống (Fallback message)