API สาธารณะของ PRING — สร้างเอกสาร kintone จากระบบภายนอก

API สาธารณะของ PRING คืออะไร

ปลั๊กอิน PRING สร้างเอกสารจากหน้าจอ kintone ส่วน API สาธารณะคือทางเข้าสำหรับเรียกการประมวลผลเดียวกันนี้จากระบบภายนอก คำขอและคำตอบเป็น JSON (UTF-8) มีเพียงไฟล์เอกสารที่รับเป็นไบนารี

เหมาะกับฝ่ายไอที บริษัทพัฒนาระบบ (SIer) พาร์ทเนอร์ที่ช่วยนำ kintone ไปใช้ และนักพัฒนาภายในองค์กร ทางเข้า API คือ https://api.pring.tech/api/v1/ ส่วนหน้าที่เขียนให้คนอ่านอยู่ในเว็บไซต์นี้และหน้าช่วยเหลือ

ทำอะไรอัตโนมัติได้บ้าง

• บันทึกเรคคอร์ดลงแอป kintone จากระบบภายนอก แล้วสร้างเอกสาร (PDF, Excel หรือ Word) ได้ในการเรียกครั้งเดียว
• สร้างเอกสาร 1 ฉบับจากเรคคอร์ดที่มีอยู่ใน kintone แล้ว
• บันทึกเรคคอร์ดทีละหลายรายการ สูงสุด 100 รายการ แล้วสร้างเอกสารพร้อมกัน (รับเป็นไฟล์ ZIP 1 ไฟล์)
• ดูรายการแอปที่ติดตั้ง PRING และเทมเพลตของแอปนั้น
• รับไฟล์เอกสารที่สร้างแล้ว (ลิงก์ที่เปิดได้ครั้งเดียวภายใน 15 นาที) หรือบันทึกลงช่องไฟล์แนบใน kintone

เชื่อมต่อกับ kintone ที่จุดไหน

เป้าหมายคือแอป kintone ที่ติดตั้งปลั๊กอิน PRING แล้ว เอกสารสร้างจากเทมเพลตของ PRING ที่ลงทะเบียนไว้ในแอปนั้น

• สร้าง API โทเคนของ kintone ในการตั้งค่าแอป (ใช้เพียง 3 สิทธิ์ คือ เพิ่มเรคคอร์ด แก้ไขเรคคอร์ด และดูเรคคอร์ด) แล้วลงทะเบียนทีละแอปในแท็บ "API" ของหน้าจอตั้งค่า PRING
• ในแท็บเดียวกัน ที่ "การเข้าถึงแต่ละแอป" ให้ตั้งแอปที่จะใช้จาก API เป็น "อนุญาต" และเลือกขอบเขตเป็น "อ่านอย่างเดียว" หรือ "อ่านและเขียน"
• API โทเคนของ kintone คือสิ่งที่ PRING ใช้เรียก kintone ส่วนการเรียก PRING จากระบบของคุณใช้ API คีย์ของ PRING ที่อธิบายต่อไป

การยืนยันตัวตนทำงานอย่างไร

ส่ง API คีย์ของ PRING แบบ Bearer ในเฮดเดอร์ Authorization ของทุกคำขอ ออกคีย์ได้ที่แท็บ "API" ของหน้าจอตั้งค่า คีย์จะแสดงเพียงครั้งเดียวตอนออก ขึ้นต้นด้วย prk_live_ สำหรับใช้งานจริง และ prk_test_ สำหรับทดสอบ

• กำหนด IP แอดเดรสที่อนุญาตให้เรียกได้สูงสุด 20 รายการต่อคีย์ ช่วยลดผลกระทบหากคีย์รั่วไหลจากเซิร์ฟเวอร์ที่ใช้ IP แอดเดรสคงที่
• มีคีย์ได้สูงสุด 20 คีย์ แยกตามระบบที่เชื่อมต่อ ยกเลิกคีย์ได้ในแท็บ "API" เมื่อต้องการเปลี่ยน ให้ออกคีย์ใหม่ก่อน แล้วจึงยกเลิกคีย์เก่า
• สื่อสารผ่าน HTTPS เท่านั้น และไม่รับคีย์ที่ใส่มาใน URL

สร้างผลลัพธ์อะไรได้บ้าง

PDF, Excel (xlsx) และ Word (docx) เลือกจากรูปแบบที่เทมเพลตที่ลงทะเบียนในแอปรองรับ แบบฟอร์ม Excel ที่มีสูตร เซลล์ที่ผสาน และรูปแบบการจัดหน้า จะกลายเป็นเอกสารตามเดิม รับเอกสารผ่านลิงก์ที่เปิดได้ในเวลาสั้น ๆ หรือบันทึกลงช่องไฟล์แนบใน kintone

ขีดจำกัดการใช้งานและอัตราการเรียกเป็นอย่างไร

• จำนวน: 1 เรคคอร์ดต่อคำขอ หรือพร้อมกันได้สูงสุด 100 รายการ
• อัตรา: สูงสุด 100 คำขอต่อวินาทีต่อ API คีย์ และมีขีดจำกัดระดับสัญญาด้วย เมื่อเกินจะได้รับ 429 พร้อม Retry-After (จำนวนวินาทีที่ต้องรอ)
• ไฟล์: ลิงก์ของไฟล์ที่สร้างแล้วเปิดได้ครั้งเดียวภายใน 15 นาที ลิงก์ ZIP ของงานที่สร้างพร้อมกันใช้ได้ 24 ชั่วโมง
• จำนวนหน้า: เอกสารที่สร้างผ่าน API นับรวมในจำนวนหน้าที่รวมต่อเดือนของแพลน เช่นเดียวกับการออกเอกสารจากหน้าจอ
• ค่าในเรคคอร์ดไม่ถูกเก็บบนเซิร์ฟเวอร์ของ PRING จะอยู่ในหน่วยความจำเฉพาะระหว่างการประมวลผล

เกี่ยวข้องกับราคาและแพลนอย่างไร

ขอดูตัวอย่างขั้นต่ำ

ตัวอย่างนี้บันทึกเรคคอร์ดใบแจ้งหนี้ลงแอปหมายเลข 19 แล้วสร้าง PDF ของเทมเพลต tpl_invoice ในการเรียกครั้งเดียว เก็บคีย์ไว้ในตัวแปรสภาพแวดล้อม PRING_API_KEY

curl -sS -X POST "https://api.pring.tech/api/v1/apps/19/records?render=tpl_invoice&format=pdf" \
  -H "Authorization: Bearer $PRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "record": { "顧客名": { "value": "サンプル商事" }, "請求日": { "value": "2026-11-01" } } }'

{
  "id": "105",
  "revision": "1",
  "file": {
    "id": "fil_01HXY...",
    "url": "https://api.pring.tech/api/v1/files/fil_01HXY...",
    "expires_at": "2026-11-01T09:15:00Z"
  }
}

ข้อผิดพลาดจะกลับมาเป็น JSON ในรูปแบบ RFC 7807 (Problem Details) ช่อง detail บอกสิ่งที่ต้องแก้

{
  "type": "https://pring.tech/ja/help/developer/public-api#errors",
  "title": "Forbidden",
  "status": 403,
  "detail": "This API key does not have the render scope.",
  "instance": "/api/v1/apps/19/records/105/render"
}

เอกสารอยู่ที่ไหน

ขั้นตอนการพัฒนาอยู่ในคู่มือสำหรับนักพัฒนาในหน้าช่วยเหลือ "วิธีใช้ API สาธารณะ" อธิบายการออกคีย์ การเข้าถึงแต่ละแอป ตัวอย่างด้วย curl, Node.js และ Python งานแบบอะซิงโครนัส รายการข้อผิดพลาดและวิธีแก้ และรายละเอียดของขีดจำกัดการใช้งาน

เลือกใช้ API สาธารณะหรือ MCP อย่างไร

กำหนดอะไรไว้เพื่อความปลอดภัยบ้าง

• จำกัดขอบเขตของ API คีย์ได้ด้วยการทำงานที่ใช้ได้ (สโคป) แอปที่ใช้ได้ และ IP แอดเดรสที่เรียกได้
• อนุญาตแอปทีละแอปใน "การเข้าถึงแต่ละแอป" (ค่าเริ่มต้นคือไม่อนุญาต) แอปที่ไม่ได้อนุญาตจะมองไม่เห็นจาก API
• API โทเคนของ kintone ถูกเก็บแบบเข้ารหัส และใช้เฉพาะตอนบันทึกและดึงเรคคอร์ด
• ยกเลิกคีย์ได้ และเปลี่ยนคีย์ได้โดยไม่ต้องหยุดการเชื่อมต่อ

อ่านต่อ

• วิธีใช้ API สาธารณะ (สำหรับนักพัฒนา)การออกคีย์ ตัวอย่าง curl, Node.js, Python งานอะซิงโครนัส และการแก้ข้อผิดพลาด
• PRING MCPสั่ง AI เอเจนต์ให้สร้างเอกสาร โดยใช้การยืนยันตัวตนและขีดจำกัดเดียวกับ API
• ราคาราคารายเดือนและจำนวนหน้ารวมของแต่ละแพลน
• สมัครเป็นพาร์ทเนอร์เสนอ PRING ให้ลูกค้า รวมถึงการต่อยอดด้วย API
• ตัวอย่างการใช้งานตัวอย่างการสร้างเอกสารด้วยชุดแอปธุรกิจสำหรับจัดซื้อ ขาย และค่าใช้จ่าย