ดูเอกสาร
ยืนยันตัวตนด้วยคีย์ API
คำขอสำหรับการพัฒนาจะใช้คีย์ API ที่สร้างขึ้นจากพื้นที่ทำงาน TurnitPass
Auth console
เก็บคีย์ API ไว้นอกเบราว์เซอร์
การเรียก API ของ TurnitPass ใช้คีย์ Bearer ที่เป็นของพื้นที่ทำงาน คีย์อยู่ในโค้ดเฉพาะเซิร์ฟเวอร์ ขณะที่แดชบอร์ดยังเป็นที่สำหรับสร้าง สลับ เพิกถอน และตรวจการใช้งาน
ราวกั้นคีย์
วิธีรักษาการเข้าถึงให้ปลอดภัย
เซิร์ฟเวอร์เท่านั้น
ส่งคีย์จากเส้นทางแบ็กเอนด์, worker, จ็อบ หรือ server action ที่ปลอดภัย
แสดงครั้งเดียว
คัดลอกคีย์ที่สร้างทันทีแล้วเก็บในตัวจัดการความลับ
สลับอย่างปลอดภัย
ปรับใช้คีย์ทดแทนก่อนเพิกถอนคีย์โปรดักชันเดิม
ขอบเขตบัญชี
การใช้งานถูกรวมเข้ายอดคำและตัวควบคุมการเรียกเก็บเงินของพื้นที่ทำงาน
คำขอ Bearer
สัญญาส่วนหัว
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"
}
คีย์ API
ส่งคีย์ API ไปพร้อมกับทุกคำขอ คีย์จะแสดงเพียงครั้งเดียวตอนสร้าง และสามารถเพิกถอนได้จากพื้นที่ทำงาน
Authorization: Bearer tp_live_your_api_key
Content-Type: application/json
POST /api/v1/humanize
Managing keys
สร้าง
สร้างคีย์ที่มีชื่อจากพื้นที่ทำงานแล้วคัดลอกทันที
เพิกถอน
ปิดคีย์ทันที คีย์ที่ถูกเพิกถอนใช้กับคำขอใหม่ไม่ได้
ขีดจำกัดอัตรา
แต่ละคีย์จำกัดอัตราได้อิสระ ขณะที่การใช้งานถูกรวมเข้าบัญชี
การเรียกเก็บเงิน
คีย์ทั้งหมดใช้ยอดคำและขีดจำกัดการสมัครของบัญชีร่วมกัน
เป็นของพื้นที่ทำงาน
Key lifecycle
สร้างคีย์ที่มีชื่อ
ใช้ชื่อที่อธิบายสภาพแวดล้อมหรือพื้นผิว เช่น Production backend, Staging worker หรือ Internal QA
คัดลอกครั้งเดียวลงที่เก็บความลับ
TurnitPass แสดงคีย์เฉพาะตอนสร้าง เก็บไว้ที่ผู้ให้บริการปรับใช้ ตัวจัดการความลับ CI หรือไฟล์ .env ในเครื่อง
ดูการใช้งานผ่าน status และการเรียกเก็บเงิน
คีย์ทั้งหมดใช้ยอดคำร่วมกัน ชื่อคีย์ช่วยให้หาได้ว่าการผสานใดกำลังทำงาน
สลับก่อนเพิกถอน
สร้างคีย์ทดแทน ปรับใช้ ยืนยันว่าทราฟฟิกปกติ แล้วเพิกถอนคีย์เดิมจากพื้นที่ทำงาน
Environment setup
เก็บคีย์ TurnitPass เป็นความลับเฉพาะเซิร์ฟเวอร์ ตัวอย่างด้านล่างใช้ชื่อทั่วไปให้เข้ากับ Next.js, Workers, จ็อบเซิร์ฟเวอร์ หรือรันไทม์แบ็กเอนด์ใดก็ได้
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"
}