ลิงก์และวิธีใช้

บัญชีสร้างที่ หน้าผู้ใช้ของ Auth · เข้าครั้งแรกด้วยรหัสชั่วคราวแล้วต้องเปลี่ยนรหัสเอง · role ให้โดย admin หรือ owner ผ่าน PUT /v1/admin/roles/{uid} (body: role, username) · ไม่มี role = ใช้ไม่ได้ (403 no_role)

ไปที่ http://192.168.100.31:14000/keys กด Sign in with TheParich · หน้าต่างของ Auth เด้งขึ้น ล็อกอินแล้วปิดเอง · ถ้า popup ถูกบล็อกใช้ ล็อกอินแบบเต็มหน้า

ตั้งชื่อ (เลือกวันหมดอายุได้) · ค่าเต็ม tpk_… แสดงครั้งเดียว คัดลอกเก็บทันที · ระบบเก็บแค่ hash ดูซ้ำไม่ได้ หายให้สร้างใหม่

ส่ง key ทาง header Authorization: Bearer เท่านั้น (ไม่รับ ?key=)

claude mcp add --transport http theparich http://192.168.100.31:14000/v1/mcp \
  --header "Authorization: Bearer tpk_xxxxxxxx"

ให้ AI เรียก about_theparich ก่อนเสมอ · api_get อ่านเส้นของ API · house_get อ่านบ้านใดก็ได้ที่ Gateway รู้จัก · และมีเครื่องมือรายเส้นของแต่ละบ้าน (<บ้าน>_<operationId>) ที่สร้างเองจากสเปก

curl -s -X POST http://192.168.100.31:14000/v1/mcp \
  -H "Authorization: Bearer tpk_xxxxxxxx" \
  -H "content-type: application/json" -H "accept: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

key อ่านได้อย่างเดียว (เขียนแล้วได้ key_read_only) · เข้า /v1/admin/* และ /v1/me/mcp-keys* ไม่ได้ · สิทธิ์ตาม role ปัจจุบันของเจ้าของ key · เพิกถอนที่หน้า /keys ได้ทันที · ดูว่า role ไหนเห็นอะไรที่ แผนผัง: MCP

ล็อกอินผ่าน SSO ของ Auth ได้ code แล้วแลกเป็น access JWT ที่ POST /v1/auth/token (ต้องมี app_id + app_secret ของแอปที่ลงทะเบียน) — ดู เชื่อมแอปใหม่เข้ากับ SSO

curl -s http://192.168.100.31:14000/v1/me -H "Authorization: Bearer <access token>"

ทุกบ้านเรียกผ่านทางเดียว /v1/gateway/<บ้าน>/… (API → Gateway → บ้าน) · บ้านที่เปิดแล้ว: meta · pancake · storage · สิทธิ์ตามที่ Gateway กำหนดต่อเส้น

curl -s http://192.168.100.31:14000/v1/gateway/meta/v1/pages \
  -H "Authorization: Bearer <access token>"
curl -s http://192.168.100.31:14000/v1/gateway/storage/v1/files/limits \
  -H "Authorization: Bearer <access token>"

API · Auth · Gateway · Storage ตอบ error เป็น RFC 9457 (application/problem+json) มี type title status detail instance และ code · ช่วงเปลี่ยนผ่านยังมี error และ message แบบเดิมให้ด้วย

API /docs — กระโดดไป #/meta · #/pancake · #/storage · บ้านใหม่ที่ลงทะเบียนใน Gateway จะโผล่เอง · ดูสิทธิ์ตาม role ที่ แผนผังระบบ

ที่ หน้าแอปของ Auth ใส่ชื่อและ callback URL · ได้ app_id + app_secret (เห็น secret ครั้งเดียว)

กดแล้วเปิด popup ไปที่ Auth (หน้าตาปุ่มใช้จาก Design System)

window.open(AUTH + "/login?app_id=…&redirect_uri=…&state=…&mode=popup")

Auth ส่ง {source:"theparich-auth", type:"login:code", code, state} มาทาง postMessage แล้วปิด popup เอง · ตรวจ state ให้ตรงกับที่ส่งไป · ผู้ใช้ที่ต้องเปลี่ยนรหัสจะถูกพาไปเปลี่ยนใน popup ก่อน

POST /v1/auth/token พร้อม code และ app_secret (ห้ามทำในหน้าเว็บ) ได้ access JWT · API ตรวจ JWT ด้วย public key แล้วหา role ใน user_roles

ปุ่มและ popup ของ หน้า /keys ของ API ทำตามขั้นตอนนี้ครบทั้งสาย · ERP รุ่นใหม่ก็ใช้แบบเดียวกัน (สถานะ ERP)