Truy cập API

WallaWhats hiển thị các hoạt động giống như bảng điều khiển sử dụng thông qua một JSON HTTP API. Sử dụng nó để viết kịch bản quản lý đăng ký, kéo lịch sử thông báo vào hệ thống của riêng bạn hoặc tích hợp cảnh báo với công cụ nội bộ. Mỗi gói trả phí bao gồm truy cập API — xem Quản lý gói để biết giới hạn khóa cho mỗi gói.

Bước 1 — Mở Khóa API

Từ thanh bên, nhấp vào Khóa API (dưới Khóa truy cập).

Bước 2 — Tạo khóa

1. Nhấp vào Tạo khóa.
2. Đặt cho khóa một tên (ví dụ production-server, local-dev). Tên chỉ là nhãn — không ảnh hưởng đến quyền.
3. Nhấp vào Tạo.

Giá trị đầy đủ của khóa được hiển thị một lần — sao chép ngay vào trình quản lý bí mật của bạn. WallaWhats chỉ lưu trữ một hash cộng với tiền tố ngắn (bws_xxxxxxxx…), vì vậy không thể khôi phục sau.

Xử lý khóa như mật khẩu

Bất kỳ ai có khóa đều có thể hành động trên tài khoản của bạn. Lưu khóa trong trình quản lý bí mật, không bao giờ commit vào git, và xoay vòng định kỳ.

Bước 3 — Sử dụng khóa

Gửi khóa trong tiêu đề x-api-key trên mỗi yêu cầu:

curl -H "x-api-key: bws_xxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  https://api.wallawhats.com/subscriptions

Các điểm cuối có sẵn, thân yêu cầu và định dạng phản hồi được ghi chép trong Tham chiếu API.

Bước 4 — Xoay vòng hoặc thu hồi

• Xoay vòng — tạo khóa mới, triển khai, sau đó xóa khóa cũ. Không có nút "xoay vòng" theo thiết kế; tạo-rồi-xóa làm cho việc chuyển đổi nguyên tử.
• Thu hồi — nhấp vào Xóa bên cạnh hàng khóa. Khóa ngừng hoạt động ngay lập tức. Bất kỳ yêu cầu đang xử lý nào sử dụng nó sẽ trả về 401 Unauthorized.

Giới hạn gói

Gói	Khóa API
Free	1
Pro	1
Pro+	2
Business	5
Enterprise	20

Nếu bạn đạt giới hạn, Tạo khóa sẽ bị vô hiệu hóa — xóa khóa cũ trước hoặc nâng cấp gói của bạn.

Tiếp theo

Đối với các lược đồ yêu cầu/phản hồi và danh sách điểm cuối đầy đủ, xem Tham chiếu API →.