Lấy API Key

API key (api_...) cho phép backend của bạn gọi Imbrace mà không cần phiên người dùng. Để biết khi nào sử dụng API key so với access token, hãy xem Xác thực.

---

Lấy API Key từ Giao diện

Bước 1 — Đăng nhập vào Cổng thông tin Imbrace, sau đó điều hướng đến GovernCore → Generate External Token.

Bước 2 — Nhấp Generate Token để cấp API key mới.

Bước 3 — Sao chép key đã được tạo. Nó bắt đầu bằng api_ và chỉ được hiển thị một lần.

---

Generate via SDK (lập trình)

Sử dụng tùy chọn này khi bạn cần tạo key từ mã, ví dụ trong quá trình cấp phát tự động. Bạn phải được xác thực bằng access token trước (qua OTP hoặc mật khẩu).

TypeScript

// Yêu cầu client được khởi tạo với access token
const res = await client.auth.getThirdPartyToken(30) // hết hạn sau 30 ngày
const apiKey = res.apiKey.apiKey  // "api_..."

Python

# Yêu cầu client được khởi tạo với access token
res = client.auth.get_third_party_token(expiration_days=30)
api_key = res["apiKey"]["apiKey"]  # "api_..."

Hình dạng phản hồi (các trường đầy đủ bên dưới — các trường nội bộ được bỏ qua để ngắn gọn):

{
  "apiKey": {
    "_id": "...",
    "apiKey": "api_...",
    "organization_id": "...",
    "user_id": "...",
    "is_active": true,
    "expired_at": "2025-08-01T00:00:00.000Z",
    "created_at": "2025-07-01T00:00:00.000Z",
    "updated_at": "2025-07-01T00:00:00.000Z",
    "is_temp": false
  },
  "expires_in": 2592000
}

---

Sử dụng key

Truyền key vào constructor client:

TypeScript

import { ImbraceClient } from "@imbrace/sdk";

const client = new ImbraceClient({
  apiKey: process.env.IMBRACE_API_KEY!,
  organizationId: process.env.IMBRACE_ORGANIZATION_ID,
  env: "stable",
});

Python

import os
from imbrace import ImbraceClient

client = ImbraceClient(
    api_key=os.environ["IMBRACE_API_KEY"],
    organization_id=os.environ.get("IMBRACE_ORGANIZATION_ID"),
    env="stable",
)