←Home/Docs
⌕

Bắt đầu nhanh

Ba bước để thực hiện cuộc gọi API CrawlPipe đầu tiên của bạn: tạo khóa API, cài đặt header xác thực, và tìm kiếm trong kho dữ liệu.

1. Tạo khóa API

Đăng ký (miễn phí, không cần thẻ) và mở mục Khóa API trong portal. Nhấp vào Tạo khóa — khóa đầy đủ (cp_live_…) chỉ hiển thị duy nhất một lần. Hãy sao chép ngay; CrawlPipe chỉ lưu trữ mã băm sha256 sau thời điểm này.

2. Cài đặt header xác thực

Mọi yêu cầu tới /v1/* đều xác thực bằng bearer token:

Authorization: Bearer cp_live_a1b2c3d4e5f6…

3. Thực hiện cuộc gọi đầu tiên

GET /v1/legal/search thực hiện tìm kiếm cấp độ đơn vị, sẵn sàng cho RAG trên kho dữ liệu. Chế độ mặc định là tìm kiếm toàn văn (mode=fts, 1 đơn vị); semantic/hybrid tốn 2 đơn vị và yêu cầu gói Builder trở lên.

curl "https://api.crawlpipe.com/v1/legal/search?q=h%C3%B3a%20%C4%91%C6%A1n%20%C4%91i%E1%BB%87n%20t%E1%BB%AD&mode=fts" \
-H "Authorization: Bearer cp_live_a1b2c3d4e5f6…"

Kết quả trả về thành công trông như thế này — mỗi kết quả đều đi kèm chuỗi citation sẵn sàng để trích dẫn:

{
  "success": true,
  "data": {
    "results": [
      {
        "score": 0.87,
        "unit": {
          "path": "c2.d5.k3",
          "unit_type": "khoan",
          "content": "Hóa đơn điện tử phải được lập theo định dạng chuẩn dữ liệu…",
          "citation": "Khoản 3 Điều 5 Thông tư 18/2026/TT-BTC"
        },
        "document": {
          "id": "…",
          "doc_number": "18/2026/TT-BTC",
          "title": "…",
          "eff_status": "con_hieu_luc",
          "effective_date": "2026-07-01",
          "source": { "key": "vbpl", "url": "…" }
        }
      }
    ]
  },
  "meta": { "request_id": "…", "units_charged": 1, "mode": "fts" }
}

Tiếp theo: đọc Xác thực để xem phạm vi khóa, Lỗi & envelope cho cấu trúc lỗi, hoặc xem hướng dẫn RAG.

Bắt đầu nhanh — CrawlPipe Docs