Skip to content

Khóa API

Khóa API cho phép bạn truy cập REST API của badges.ninja theo cách lập trình. Hãy dùng chúng để tự động tạo, cấp và quản lý huy hiệu từ ứng dụng của bạn.

Khóa API — trạng thái trống

Tạo khóa API

  1. Mở trang Khóa API từ thanh bên.
  2. Nhấp Tạo khóa API. Biểu mẫu bên trong sẽ mở ra:

Tạo khóa — biểu mẫu tên

  1. Đặt tên cho khóa rồi nhấp Tạo. Khóa đầy đủ sẽ hiện một lần trên một biểu ngữ màu xanh:

Khóa vừa tạo chỉ hiện một lần

  1. Sao chép khóa ngay lập tức — khóa chỉ hiện một lần. Nếu bạn làm mất, bạn sẽ phải tạo khóa mới. Sau khi đóng biểu ngữ, chỉ tiền tố được lưu:

Danh sách khóa hiển thị tiền tố đã che

Định dạng khóa

Khóa API dùng tiền tố bws_ theo sau là chuỗi hex dài 32 ký tự:

bws_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6

Dùng khóa API trong yêu cầu

Đưa khóa API vào header X-Api-Key của mỗi yêu cầu API:

bash
curl -X GET https://api.badges.ninja/issuers \
  -H "X-Api-Key: bws_your_api_key_here"

Xem trang Xác thực để có chi tiết đầy đủ.

Hạn mức khóa theo gói

Số lượng khóa API bạn có thể tạo tùy theo gói:

GóiGiới hạn khóa API
Free1
Starter ($9/mo)5
Pro ($29/mo)20

Xóa khóa

  1. Mở trang Khóa API.
  2. Tìm khóa bạn muốn xóa.
  3. Nhấp Xóa.
  4. Xác nhận việc xóa.

Xác nhận xóa khóa — thu hồi có hiệu lực ngay

Sau khi xóa, khóa sẽ ngừng hoạt động ngay lập tức. Bất kỳ ứng dụng nào đang dùng khóa đó sẽ nhận lỗi xác thực.

badges.ninja Documentation