เอกสารอ้างอิง

เอกสารอ้างอิง API

เอกสารอ้างอิง OpenAPI ที่โฮสต์ไว้อยู่ที่ใด วิธียืนยันตัวตน ทุกการตอบกลับมีหน้าตาอย่างไร และขีดจำกัดอัตรา

เอกสารอ้างอิง API ฉบับสมบูรณ์ของ Polylane สร้างจากข้อกำหนด OpenAPI ที่แพลตฟอร์มให้บริการ จึงตรงกับสิ่งที่ deploy อยู่เสมอ

เปิดเอกสารอ้างอิง API

ทุก operation รูปร่างคำขอและการตอบกลับ และตัวอย่างคำขอที่คัดลอกได้

การยืนยันตัวตน

ส่งคีย์ API ของ workspace ใน header x-api-key หรือ access token แบบ OAuth ใน Authorization: Bearer สร้างอย่างใดอย่างหนึ่งในคอนโซล ดู คีย์ API และไคลเอนต์ OAuth

Terminal
curl https://api.polylane.com/v1/workspaces \
  -H "x-api-key: $POLYLANE_API_KEY"

รูปแบบการตอบกลับ

ทุกการตอบกลับแบบ JSON ใช้ envelope เดียวกัน

ฟิลด์คำอธิบาย
successtrue เมื่อคำขอสำเร็จ false เมื่อล้มเหลว
messageเมื่อสำเร็จ อ็อบเจกต์ที่ message ของมันอธิบายสถานะ null เมื่อล้มเหลว
errornull เมื่อสำเร็จ เมื่อล้มเหลว อ็อบเจกต์ที่มี message และ detail กับ metadata ที่ไม่บังคับ
resultpayload เมื่อสำเร็จ ไม่มีเมื่อล้มเหลว
{
  "success": true,
  "message": { "message": "Successful request" },
  "error": null,
  "result": { "items": [], "count": 0 }
}

ขีดจำกัดอัตรา

พื้นผิวขีดจำกัด
REST API5,000 คำขอต่อ 60 วินาทีต่อข้อมูลรับรอง
เซิร์ฟเวอร์ MCP ของแพลตฟอร์ม600 คำขอต่อ 60 วินาทีต่อข้อมูลรับรอง

การตอบกลับประกาศนโยบายใน header RateLimit-Limit และ RateLimit-Policy เมื่อเกินขีดจำกัด API จะตอบ 429 พร้อม header Retry-After ที่บอกหน้าต่างเวลาเป็นวินาที ให้รอจนกว่าจะพ้นช่วงนั้นแล้วลองใหม่

ทุก operation ยังเรียกได้จาก CLI ซึ่งสร้างจากข้อกำหนดเดียวกัน

ที่เกี่ยวข้อง