Xem tài liệu
Xác thực bằng khóa API
Các yêu cầu phát triển sử dụng khóa API được tạo từ khu vực làm việc TurnitPass.
Auth console
Giữ khóa API ngoài trình duyệt.
Lời gọi API TurnitPass dùng khóa Bearer thuộc khu vực làm việc. Khóa chỉ nằm trong mã máy chủ; bảng điều khiển vẫn là nơi tạo, xoay, thu hồi và xem mức dùng.
Hàng rào khóa
Cách giữ quyền truy cập an toàn
Chỉ máy chủ
Gửi khóa từ route backend, worker, job hoặc server action bảo mật.
Hiện một lần
Sao chép khóa vừa tạo ngay và lưu vào trình quản lý secret.
Xoay an toàn
Triển khai khóa thay thế trước khi thu hồi khóa production cũ.
Theo tài khoản
Mức dùng được cộng vào số từ còn lại và kiểm soát thanh toán của khu vực làm việc.
Yêu cầu Bearer
Hợp đồng header
fetch('https://turnitpass.com/api/v1/humanize', {
method: 'POST',
headers: {
Authorization: 'Bearer tp_live_your_api_key',
'Content-Type': 'application/json'
},
body: JSON.stringify({ text: draft, language: 'en' })
})
{
"error": "Invalid or revoked API key.",
"code": "invalid_api_key"
}
Khóa API
Gửi khóa API cùng với mỗi yêu cầu. Khóa chỉ hiển thị một lần và có thể thu hồi từ khu vực làm việc.
Authorization: Bearer tp_live_your_api_key
Content-Type: application/json
POST /api/v1/humanize
Managing keys
Tạo
Tạo khóa có tên từ khu vực làm việc và sao chép ngay.
Thu hồi
Vô hiệu hóa khóa ngay lập tức. Khóa đã thu hồi không dùng cho yêu cầu mới.
Giới hạn tốc độ
Mỗi khóa có thể bị giới hạn độc lập, trong khi mức dùng vẫn cộng vào tài khoản.
Thanh toán
Mọi khóa dùng chung số từ còn lại và giới hạn gói của tài khoản.
Thuộc khu vực làm việc
Key lifecycle
Tạo khóa có tên
Đặt tên mô tả môi trường hoặc bề mặt, ví dụ Production backend, Staging worker hoặc Internal QA.
Sao chép một lần vào kho secret
TurnitPass chỉ hiện khóa lúc tạo. Lưu vào nhà cung cấp triển khai, trình quản lý secret CI hoặc tệp .env local.
Theo dõi mức dùng qua status và thanh toán
Mọi khóa dùng chung số từ còn lại; tên khóa giúp nhận ra tích hợp nào đang chạy.
Xoay trước khi thu hồi
Tạo khóa thay thế, triển khai, xác nhận lưu lượng ổn, rồi thu hồi khóa cũ từ khu vực làm việc.
Environment setup
Lưu khóa TurnitPass như secret chỉ dành cho máy chủ. Các ví dụ dưới dùng tên chung cho Next.js, Workers, job máy chủ hoặc mọi runtime backend.
TURNITPASS_API_KEY=tp_live_your_api_key
TURNITPASS_API_BASE_URL=https://turnitpass.com/api/v1
Security best practices
Authentication errors
{
"error": "Invalid or revoked API key.",
"code": "invalid_api_key"
}