> ## Documentation Index
> Fetch the complete documentation index at: https://hoalulab.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Hướng dẫn nhanh

> Chuẩn bị OAuth scope và gửi yêu cầu đầu tiên đến FireAnt REST API.

## Trước khi bắt đầu

Bạn cần có ứng dụng hoặc tài khoản được FireAnt cấp quyền API, OAuth access token và một HTTP client để gửi request.

<Warning>
  Không lưu access token trong mã nguồn hoặc repository. Chỉ cấp các OAuth scope cần thiết cho ứng dụng.
</Warning>

## Kết nối với API

<Steps>
  <Step title="Chọn endpoint">
    Mở **API Reference** trong tab FireAnt. Bắt đầu bằng endpoint chỉ đọc thuộc nhóm dữ liệu bạn cần.
  </Step>

  <Step title="Kiểm tra OAuth scope">
    Đọc mục xác thực của endpoint và bảo đảm access token có scope tương ứng, ví dụ scope đọc dữ liệu mã chứng khoán hoặc tài chính.
  </Step>

  <Step title="Gửi access token">
    Điền token trong API Playground hoặc gửi header `Authorization` theo định dạng mà FireAnt yêu cầu.
  </Step>

  <Step title="Kiểm tra phản hồi">
    Xác nhận mã trạng thái, content type và schema dữ liệu. Xử lý lỗi thiếu scope hoặc token hết hạn trước khi mở rộng tích hợp.
  </Step>
</Steps>

<Tip>
  Tách token theo môi trường và phạm vi quyền để giảm rủi ro khi phát triển và kiểm thử.
</Tip>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.