GitHub เพิ่ม API ค้น Cost Center จาก User, Repository และ Team โดยตรง
GitHub REST API ค้น cost center membership ตามทรัพยากรได้ ไม่ต้องไล่ทุก cost center พร้อมข้อควรระวังเรื่องสิทธิ์ Enterprise billing
GitHub ประกาศเมื่อวันที่ 3 พฤศจิกายน 2026 ว่า REST API สำหรับ GitHub Enterprise Cloud สามารถค้นได้โดยตรงว่าผู้ใช้ องค์กร repository หรือ enterprise team อยู่ใน cost center ใด ก่อนหน้านี้ผู้ดูแลระบบต้องดึงรายการ cost center ทั้งหมดแล้วไล่ตรวจสมาชิกของแต่ละรายการเอง การเปลี่ยนแปลงนี้ช่วยให้ระบบรายงานค่าใช้จ่ายและงานตรวจสอบสิทธิ์เริ่มจากทรัพยากรที่สนใจได้ทันที แต่ผู้เรียก API ยังต้องมีสิทธิ์ด้าน enterprise billing ตามบทบาทของตน
API ใหม่แก้ปัญหาอะไร
Cost center เป็นกลไกแยกความรับผิดชอบด้านค่าใช้จ่ายใน enterprise เช่น แยกทีมผลิตภัณฑ์ แผนก หรือโครงการ เมื่อมี repository หรือสมาชิกจำนวนมาก คำถามที่เกิดในงานจริงมักเป็น “repo นี้ถูกคิดค่าใช้จ่ายที่ไหน” มากกว่า “cost center นี้มีอะไรบ้าง” วิธีเดิมต้องอ่านทุก cost center ซึ่งเพิ่มจำนวนคำขอ API และทำให้โค้ดฝั่งผู้ดูแลต้องจัดการ pagination และการเทียบชื่อเอง
Endpoint ที่ GitHub เพิ่มคือ GET /enterprises/{enterprise}/settings/billing/cost-centers/memberships ผู้เรียกส่ง resource_type และ name แล้วรับข้อมูล resource และอาร์เรย์ memberships กลับมา ประเภทที่รองรับคือ user, repository, organization และ team สำหรับ repository ให้ใช้ชื่อรูปแบบ owner/repo ส่วน team ให้ใช้ enterprise team slug ตามเอกสาร API หากทรัพยากรไม่ได้อยู่ใน cost center อาร์เรย์ memberships จะว่าง นั่นต่างจากสถานะที่ API หา resource ไม่พบ ซึ่งเอกสารระบุเป็น HTTP 404
ตัวอย่างเชิงแนวคิดคือระบบรับชื่อ engineering/api แล้วเรียก endpoint พร้อม resource_type=repository และ name=engineering/api จากนั้นอ่าน memberships[].cost_center.id และ memberships[].cost_center.name เพื่อแสดงข้อมูลในหน้า inventory หรือเชื่อมกับรายงานงบประมาณ ไม่ควรเขียนโค้ดสมมติว่ามีสมาชิกเพียงหนึ่งรายการเสมอ เพราะ schema ส่งกลับเป็นอาร์เรย์ และควรแยกกรณีอาร์เรย์ว่างออกจากข้อผิดพลาด 403, 404 และ 503 ให้ชัดเจน
สิทธิ์และวิธีพิสูจน์ตัวตนต้องตรวจแยกกัน
ประกาศระบุว่า enterprise owner, billing manager และ GitHub App ที่มีสิทธิ์อ่าน enterprise billing สามารถค้นทรัพยากรใน enterprise ได้กว้างกว่า organization owner หรือผู้ถือ custom role ที่มีสิทธิ์อ่าน ซึ่งมองเห็นเฉพาะทรัพยากรและ cost center ที่ตนเข้าถึงอยู่แล้ว ดังนั้นผลลัพธ์ของบัญชีสองชุดอาจต่างกันเพราะขอบเขตสิทธิ์ ไม่ใช่เพราะข้อมูล billing หาย ผู้พัฒนา integration ควรทดสอบด้วยตัวตนเดียวกับที่ใช้ใน production
เอกสาร REST API มีข้อควรระวังสำคัญ: สิทธิ์ Enterprise billing สำหรับ GitHub App ยังไม่ได้เปิดให้ลงทะเบียนได้ทั่วไปทุก enterprise แม้หน้ารายละเอียด endpoint จะระบุ GitHub App token ว่าใช้ได้ กรณีองค์กรยังให้สิทธิ์นี้แก่ App ไม่ได้ เอกสารแนะนำให้ enterprise owner หรือ billing manager ใช้ personal access token แบบ classic หรือ OAuth token ที่มี scope manage_billing:enterprise โดยผู้ถือโทเค็นต้องเข้าถึง resource นั้นจริง Fine-grained personal access token ใช้กับ endpoint กลุ่ม enterprise นี้ไม่ได้ อย่าออกแบบระบบโดยสมมติว่า App token ใช้งานได้ทุก tenant
ในตัวอย่างเอกสาร GitHub ใช้ header Accept: application/vnd.github+json และ X-GitHub-Api-Version: 2026-03-10 ร่วมกับ Bearer token ควรเก็บโทเค็นในระบบจัดการความลับ ไม่ใส่ใน source code หรือ log และจำกัดสิทธิ์ของ service account ตามงานที่ต้องทำ ใน GitHub Enterprise บน GHE.com ฐาน URL ของ API เปลี่ยนเป็นโดเมนเฉพาะขององค์กรตามเอกสาร ไม่ควร hard-code api.github.com หากระบบต้องรองรับสภาพแวดล้อมนั้น
นำไปใช้กับงาน FinOps อย่างไร
จุดเริ่มที่มีประโยชน์คือ inventory รายวัน: ดึงรายการ repository หรือ team ที่องค์กรดูแลอยู่ แล้วเรียก membership lookup เพื่อจับคู่กับ cost center ในฐานข้อมูลรายงาน หากได้อาร์เรย์ว่าง ให้แจ้งผู้รับผิดชอบตรวจการจัดสรร แต่อย่าตีความว่า GitHub คิดค่าใช้จ่ายผิดโดยอัตโนมัติ เพราะการคิดค่าใช้จ่ายขึ้นกับชนิด resource และการตั้งค่า billing ของ enterprise ด้วย การเปลี่ยน membership ควรบันทึกเวลาและผู้รับผิดชอบในระบบขององค์กร เพื่อย้อนตรวจเหตุผลของรายงานย้อนหลังได้
อีกกรณีคือขั้นตอนสร้าง repository ใหม่ หลังสร้างสำเร็จ สามารถตรวจว่ามี cost center ที่คาดไว้หรือไม่ก่อนเปิดใช้บริการที่มีค่าใช้จ่ายสูง แต่ API นี้เป็นการอ่านข้อมูลสมาชิก ไม่ใช่ตัวบังคับนโยบายการสร้าง repo หากต้องเปลี่ยนการจัดสรร GitHub มี endpoint เพิ่มและลบ resource จาก cost center แยกต่างหาก ซึ่งต้องใช้สิทธิ์เขียน การแยกสิทธิ์อ่านกับเขียนช่วยลดความเสี่ยงที่งานตรวจสอบจะเปลี่ยนข้อมูล billing โดยไม่ตั้งใจ
ผู้ดูแลควรวัดอัตรา 403, 404 และ response ว่างในช่วงเริ่มใช้ พร้อมตรวจชื่อ resource ที่ส่ง โดยเฉพาะการเข้ารหัส owner/repo ใน query string ถ้าระบบเคยวนอ่านทุก cost center การย้ายมาใช้ lookup ตรงช่วยทำให้โค้ดสั้นลงและลดคำขอที่ไม่จำเป็น แต่ควรเปรียบเทียบผลกับรายการเดิมช่วงเปลี่ยนผ่านเพื่อจับข้อผิดพลาดด้านชื่อและสิทธิ์
แหล่งต้นทาง: ประกาศ GitHub วันที่ 3 พฤศจิกายน 2026 และ เอกสาร REST API สำหรับ cost centers