วิธีตั้งค่าพารามิเตอร์ส่วนกลางใน Apidog (ส่ง Auth Headers ทุกคำขอ)

เรียนรู้วิธีตั้งค่าพารามิเตอร์ส่วนกลางใน Apidog เพื่อเพิ่ม Authorization bearer token และ header เวอร์ชันลงในทุกคำขอโดยอัตโนมัติ ไม่ต้องแก้ไขทีละปลายทาง

INEZA Felin-Michel

INEZA Felin-Michel

16 July 2026

วิธีตั้งค่าพารามิเตอร์ส่วนกลางใน Apidog (ส่ง Auth Headers ทุกคำขอ)

Apidog สำหรับองค์กร

การติดตั้งแบบ On-Premises

SSO & RBAC

รองรับมาตรฐาน SOC 2

สำรวจ Apidog Enterprise

คุณมี 40 Endpoint ในโปรเจกต์ และทุกๆ Endpoint ต้องการเฮดเดอร์ Authorization: Bearer ... และเฮดเดอร์ X-Api-Version เดียวกันในการเรียกใช้ทุกครั้ง การเพิ่มสองบรรทัดนี้ด้วยมือในแต่ละคำขอเป็นเรื่องที่ช้า และที่แย่กว่านั้นคือมันมีโอกาสผิดพลาด Endpoint หนึ่งได้โทเค็น แต่อีก Endpoint หนึ่งอาจถูกลืม และคุณจะเสียเวลาไปทั้งบ่ายกับการไล่ตามหาข้อผิดพลาด 401 ที่ปรากฏในเพียงสามเส้นทางจากสี่สิบเส้นทาง

มีวิธีที่ดีกว่านั้น Apidog ช่วยให้คุณกำหนดพารามิเตอร์เพียงครั้งเดียวและให้พารามิเตอร์เหล่านั้นนำไปใช้กับทุกคำขอโดยอัตโนมัติ ตั้งค่าเฮดเดอร์ที่ระดับโปรเจกต์ อ้างอิงโทเค็นของคุณเป็นตัวแปร และทุก Endpoint จะได้รับค่าเหล่านั้นโดยที่คุณไม่ต้องแตะต้องคำขอใดๆ คู่มือนี้จะแนะนำสามวิธีที่ระบุไว้สำหรับเรื่องนี้: พารามิเตอร์ส่วนกลาง (global parameters), ตัวแปรสภาพแวดล้อม (environment variables) และการสำรองสคริปต์ที่กำหนดขอบเขตตามโฟลเดอร์ (folder-scoped script fallback) คุณจะได้รับชุดค่าผสมที่ใช้งานได้ซึ่งจะแนบเฮดเดอร์สำหรับการยืนยันตัวตนและเฮดเดอร์เวอร์ชันเข้ากับทุกอย่าง พร้อมวิธีพิสูจน์ว่าเฮดเดอร์ได้ถูกส่งออกไปจริงๆ หากคุณต้องการข้อมูลเบื้องหลังที่ลึกซึ้งเกี่ยวกับตัวแปรก่อน คู่มือของเราเรื่อง การควบคุมตัวแปรใน Apidog จะเป็นส่วนเสริมที่ดีสำหรับบทความนี้

button

แนวคิดของคำขอที่พกพาเฮดเดอร์มาตรฐานในการเรียกใช้ทุกครั้งไม่ได้มีเฉพาะใน Apidog เท่านั้น มันเป็นรูปแบบเดียวกันกับที่ ข้อมูลอ้างอิงเฮดเดอร์ HTTP ของ MDN อธิบายไว้: ชุดคู่คีย์/ค่าเล็กๆ ที่เดินทางไปพร้อมกับคำขอแต่ละครั้ง งานของ Apidog คือให้คุณตั้งค่าชุดนั้นเพียงครั้งเดียว

“พารามิเตอร์ส่วนกลาง” หมายถึงอะไรกันแน่

พารามิเตอร์ส่วนกลางใน Apidog คือพารามิเตอร์คำขอที่นำไปใช้กับทั้งโปรเจกต์ แทนที่จะเป็นเพียง Endpoint เดียว คุณกำหนดมันเพียงครั้งเดียว และ Apidog จะแนบมันเข้ากับคำขอที่ตรงกันโดยอัตโนมัติ

พารามิเตอร์ส่วนกลางครอบคลุมสี่ตำแหน่ง และนี่คือหัวใจสำคัญของฟีเจอร์นี้:

สำหรับกรณีการใช้งานเฮดเดอร์ยืนยันตัวตน คุณต้องการเฮดเดอร์ (Headers) ส่วนอีกสามตำแหน่งที่เหลือก็ทำงานในลักษณะเดียวกัน หากค่ามาตรฐานของคุณอยู่ในคุกกี้ สตริงคิวรี หรือฟิลด์บอดี้แทน

มีกฎหนึ่งข้อที่สำคัญก่อนที่คุณจะเริ่มต้น: พารามิเตอร์ส่วนกลางมีความสำคัญต่ำกว่าพารามิเตอร์ที่กำหนดในระดับ Endpoint หากคำขอเฉพาะเจาะจงมีการตั้งค่าเฮดเดอร์ Authorization ของตัวเองอยู่แล้ว ค่าที่ระดับ Endpoint นั้นจะถูกนำมาใช้ และค่าส่วนกลางจะถูกละเว้น ให้คิดว่าพารามิเตอร์ส่วนกลางเป็นค่าเริ่มต้นที่ใช้เติมเมื่อ Endpoint ไม่ได้ระบุค่าของตัวเอง ไม่ใช่การแทนที่แบบแข็งที่ทับทุกสิ่งทุกอย่าง ลำดับความสำคัญนี้เองที่ทำให้พารามิเตอร์ส่วนกลางปลอดภัยในการเปิดใช้งานทั่วทั้งโปรเจกต์ขนาดใหญ่

ตั้งค่าเฮดเดอร์ส่วนกลางในทุกคำขอ

นี่คือขั้นตอนหลักๆ เป้าหมาย: แนบ Authorization และ X-Api-Version เข้ากับทุก Endpoint ในโปรเจกต์โดยไม่ต้องแก้ไข Endpoint ใดๆ เลย

ขั้นตอนที่ 1: เปิดการจัดการสภาพแวดล้อม (Environment Management)

พารามิเตอร์ส่วนกลางจะอยู่ใน Environment Management ซึ่งคุณสามารถเปิดได้จากมุมขวาบนของหน้า นี่คือจุดเริ่มต้นสำหรับพารามิเตอร์ที่ใช้กับทั้งโปรเจกต์ และ เอกสารของ Apidog อธิบายว่าเป็นที่เก็บค่าที่ใช้กับทุกคำขอ เปิดมันขึ้นมาแล้วคุณจะเห็นส่วนที่คุณสามารถเพิ่มพารามิเตอร์ตามตำแหน่งได้

ขั้นตอนที่ 2: เลือกตำแหน่งเฮดเดอร์ (Headers)

เลือก Headers (ตำแหน่ง Request Header) เนื่องจากคุณกำลังเพิ่มเฮดเดอร์ยืนยันตัวตน หากค่ามาตรฐานของคุณเป็นคุกกี้ พารามิเตอร์คิวรี หรือฟิลด์บอดี้ คุณก็จะเลือก Cookies, Query หรือ Body แทน กลไกการทำงานเหมือนกันทั้งสี่ตำแหน่ง

ขั้นตอนที่ 3: กรอกรายละเอียดพารามิเตอร์

พารามิเตอร์ส่วนกลางแต่ละรายการมีชุดคุณสมบัติที่กำหนดไว้ตายตัว กรอกข้อมูลสำหรับเฮดเดอร์แรกของคุณ:

ฟิลด์ Default และเครื่องหมายที่จำเป็น (ดอกจัน *) ก็จะปรากฏบนพารามิเตอร์ที่จำเป็น เพิ่มแถวที่สองในลักษณะเดียวกันสำหรับเฮดเดอร์เวอร์ชัน:

ขั้นตอนที่ 4: เปิดใช้งานพารามิเตอร์

พารามิเตอร์แต่ละตัวมีสวิตช์เปิด/ปิดอยู่ทางด้านขวา เปิดมันเพื่อเปิดใช้งานพารามิเตอร์ การสลับนี้มีประโยชน์ในภายหลัง: หากคุณต้องการปิดใช้งานเฮดเดอร์ส่วนกลางสำหรับการดีบัก คุณสามารถปิดที่นี่แทนที่จะลบและพิมพ์ใหม่ทั้งหมด

ขั้นตอนที่ 5: บันทึก

บันทึกการตั้งค่า ตอนนี้เฮดเดอร์ทั้งสองเป็นส่วนกลางแล้ว คำขอทุกรายการในโปรเจกต์จะพกพา Authorization และ X-Api-Version เว้นแต่ว่า Endpoint ใด Endpoint หนึ่งจะแก้ไขค่าใดค่าหนึ่ง

ขั้นตอนที่ 6: พิสูจน์ว่ามันถูกส่งออกไปจริงๆ

อย่าเพิ่งเชื่อว่ามันใช้ได้ ให้ตรวจสอบ ส่งคำขอใดๆ ในโปรเจกต์ จากนั้นเปิดแท็บ Actual Request ในคอนโซลการตอบกลับ แท็บนี้แสดงคำขอตามที่ถูกส่งออกไปจริง โดยมีตัวแปรที่ถูกแทนที่ด้วยค่าจริงแล้ว คุณควรเห็นเฮดเดอร์ทั้งสองรายการปรากฏอยู่ที่นั่น:

GET /v1/orders/8842 HTTP/1.1
Host: api.yourservice.com
Authorization: Bearer sk_live_7f3a9c2e1b8d4056
X-Api-Version: 2024-08-01

ถ้าเฮดเดอร์ปรากฏใน Actual Request แสดงว่ามันถูกส่งออกไปแล้ว นี่คือจุดที่สำคัญที่สุดในการตั้งค่าทั้งหมด เพราะมันเปลี่ยนจาก "ฉันคิดว่ามันถูกใช้แล้ว" เป็น "ฉันเห็นแล้วว่ามันถูกใช้แล้ว"

เก็บความลับออกจากเฮดเดอร์: ใช้ตัวแปร

สังเกตว่าค่าเริ่มต้น (Default Value) ด้านบนคือ Bearer {{token}} ไม่ใช่ Bearer sk_live_7f3a9c2e1b8d4056 ไวยากรณ์วงเล็บปีกกาคู่ (double-brace) นี้อ้างอิงถึงตัวแปรแทนที่จะฮาร์ดโค้ดโทเค็นดิบลงในพารามิเตอร์ รูปแบบ Bearer เองถูกกำหนดใน RFC 6750 และ ข้อมูลอ้างอิงเฮดเดอร์ Authorization ของ MDN ครอบคลุมวิธีการที่เซิร์ฟเวอร์อ่านมัน เอกสารของ Apidog ชี้ชัดถึงมุมมองด้านความปลอดภัย: สำหรับข้อมูลที่ละเอียดอ่อนเช่น โทเค็นยืนยันตัวตนและคีย์ API ให้ใช้ตัวแปรสภาพแวดล้อมแทนการเก็บค่าดิบเป็นค่าเริ่มต้นแบบข้อความธรรมดา ตัวแปรคือตัวยึดตำแหน่งแบบไดนามิกสำหรับค่าที่คุณใช้ในคำขอและสคริปต์หลายรายการ และมันช่วยเก็บความลับออกจากคำจำกัดความของพารามิเตอร์

นี่คือวิธีการตั้งค่าตัวแปร token:

  1. คลิกไอคอนสภาพแวดล้อม (ไอคอน ) ที่มุมขวาบน โปรดทราบว่านี่คือจุดเริ่มต้นที่แตกต่างจากการจัดการสภาพแวดล้อม: ไอคอน คือที่ที่ตัวแปรอยู่
  2. ค้นหาส่วน Global Variables
  3. สร้างตัวแปร ตัวอย่างเช่น token ด้วยค่า secret bearer ของคุณ
  4. คลิก Save

ตอนนี้ค่าเฮดเดอร์ส่วนกลางของคุณ Bearer {{token}} จะถูกแปลงเป็น Bearer <your-real-secret> เมื่อถึงเวลาส่ง และแท็บ Actual Request จะยืนยันการแทนที่นี้ การเลื่อนเมาส์ไปเหนือชื่อตัวแปรที่ใดก็ได้จะแสดงค่าปัจจุบันและขอบเขต ซึ่งเป็นวิธีที่รวดเร็วในการตรวจสอบว่าคุณอ้างอิงถึงตัวแปรที่ถูกต้อง

การจับคู่กันนี้เป็นรูปแบบที่แนะนำ: พารามิเตอร์ส่วนกลาง เป็นเจ้าของช่องเฮดเดอร์ และ ตัวแปร เป็นเจ้าของความลับ บทความเชิงลึกของเราเกี่ยวกับการ จัดการสภาพแวดล้อมและข้อมูลลับของ API client จะอธิบายเพิ่มเติมเกี่ยวกับวิธีเก็บโทเค็นออกจากสิ่งที่คุณอาจจะแชร์หรือคอมมิต

สลับค่าตามสภาพแวดล้อม

ตัวแปรจะมีประโยชน์มากขึ้นเมื่อคุณมีมากกว่าหนึ่งโปรเจกต์จริงจะเรียกใช้เซิร์ฟเวอร์ที่แตกต่างกันสำหรับ Development, Testing และ Production และแต่ละเซิร์ฟเวอร์มักจะต้องการโทเค็นที่แตกต่างกัน จัดกลุ่มแต่ละชุดภายใต้สภาพแวดล้อมของตัวเอง จากนั้นสลับระหว่างกันด้วย Environments dropdown ที่อยู่ถัดจากไอคอน (สภาพแวดล้อมตัวอย่างอาจมีชื่อว่า Local Mock) การสลับสภาพแวดล้อมจะชี้คำขอของคุณไปยังชุดเซิร์ฟเวอร์ที่แตกต่างกัน และสลับค่าตัวแปรของสภาพแวดล้อมนั้น เฮดเดอร์ Bearer {{token}} ส่วนกลางของคุณยังคงเดิม มีเพียงค่า secret ที่ถูกแปลงเท่านั้นที่เปลี่ยนแปลงไปตามสภาพแวดล้อม หากคุณกำลังสร้างโฟลว์การยืนยันตัวตนบนพื้นฐานนี้ แนวคิดใน คู่มือ Security schemes ของเราจะอธิบายว่าคำจำกัดความของ bearer, API-key และ OAuth แผนที่ไปสู่คำขอจริงได้อย่างไร

เมื่อคุณต้องการเฮดเดอร์ในโฟลเดอร์เดียวเท่านั้น

พารามิเตอร์ส่วนกลางจะใช้กับทั้งโปรเจกต์ บางครั้งมันก็กว้างเกินไป สมมติว่าเฉพาะ Endpoint /admin ของคุณเท่านั้นที่ต้องการเฮดเดอร์ X-Admin-Scope และส่วนที่เหลือของโปรเจกต์ไม่ควรพกพามันไป

นี่คือข้อจำกัดที่แท้จริง: Apidog ไม่มีฟิลด์ "เพิ่มเฮดเดอร์" ในการตั้งค่าโฟลเดอร์ ไม่มี UI สำหรับเฮดเดอร์ระดับโฟลเดอร์ให้กรอก สิ่งที่เอกสารระบุไว้แทนคือวิธีแก้ปัญหาโดยใช้สคริปต์ก่อนคำขอ (pre-request script) ที่ระดับโฟลเดอร์ เพื่อให้ทุกคำขอภายในโฟลเดอร์นั้นรับค่าเฮดเดอร์ดังกล่าว สคริปต์นี้ใช้สคริปต์ pm.* ที่เข้ากันได้กับ Postman:

pm.request.headers.add({ key: 'X-Admin-Scope', value: 'full' });

เพิ่มสิ่งนี้เป็นสคริปต์ก่อนคำขอในโฟลเดอร์ และทุกคำขอในโฟลเดอร์นั้นจะได้รับเฮดเดอร์ ในขณะที่คำขอนอกโฟลเดอร์จะไม่ได้รับ มันเป็นสคริปต์ ไม่ใช่สวิตช์การตั้งค่า ดังนั้นให้ถือว่าเป็นวิธีสำรองสำหรับความต้องการที่กำหนดขอบเขตตามโฟลเดอร์ ไม่ใช่เส้นทางหลัก สำหรับโมเดลการเขียนสคริปต์ที่กว้างขึ้นซึ่งเป็นพื้นฐานของสิ่งนี้ โปรดดูคู่มือของเราเกี่ยวกับ สคริปต์ก่อนและหลังคำขอใน Apidog

ควรใช้อะไรและเมื่อไหร่

ตอนนี้คุณมีสามวิธีในการแนบเฮดเดอร์โดยไม่ต้องแก้ไข Endpoint เลือกตามขอบเขต:

มีบางสิ่งที่ต้องระวัง ตรวจสอบชื่อพารามิเตอร์ที่ซ้ำกันเพื่อไม่ให้เฮดเดอร์ส่วนกลางสองตัวชนกัน และตรวจสอบให้แน่ใจว่าประเภท (Type) ของแต่ละพารามิเตอร์ตรงกับวิธีการใช้งาน และจำกฎลำดับความสำคัญ: Endpoint ที่ตั้งค่า Authorization ของตัวเองจะแทนที่ค่าส่วนกลาง ซึ่งเป็นคุณสมบัติเมื่อเส้นทางหนึ่งต้องการโทเค็นที่แตกต่างกัน แต่ก็อาจทำให้ประหลาดใจหากคุณลืมว่าเส้นทางนั้นมีค่าของตัวเอง คุณสมบัติทั้งสามนี้ไม่มีข้อจำกัดใดๆ ในเอกสาร ดังนั้นคุณไม่จำเป็นต้องมีระดับ (tier) เฉพาะเพื่อใช้งาน

ทำให้เวิร์คโฟลว์เป็นไปโดยอัตโนมัติด้วย Apidog CLI

พารามิเตอร์ส่วนกลางและสภาพแวดล้อมไม่ได้เป็นเพียงความสะดวกสบายของ GUI เท่านั้น แต่ยังสามารถนำไปใช้ในการรันอัตโนมัติได้ด้วย เมื่อคุณสร้างสถานการณ์การทดสอบที่บันทึกไว้ใน Apidog และรันจากบรรทัดคำสั่ง การรันนั้นจะสืบทอดสภาพแวดล้อมที่คุณส่งผ่าน id ดังนั้นเฮดเดอร์ Bearer {{token}} และค่า X-Api-Version เดียวกันที่ใช้ได้ใน GUI จะถูกแปลงในลักษณะเดียวกันใน CI

ติดตั้ง CLI (Node.js v16+) และยืนยันตัวตน:

npm install -g apidog-cli
apidog login --with-token <YOUR_ACCESS_TOKEN>

จากนั้นรันสถานการณ์ที่บันทึกไว้กับสภาพแวดล้อมที่เฉพาะเจาะจง:

apidog run --access-token $APIDOG_ACCESS_TOKEN -t <scenario_id> -e <env_id> -r cli

-e เลือกสภาพแวดล้อม ดังนั้นสถานการณ์จะใช้ตัวแปรของสภาพแวดล้อมนั้น รวมถึงโทเค็นของคุณ แฟล็ก -t คือ id ของสถานการณ์การทดสอบ และ -r คือตัวรายงาน (cli, html, หรือ junit) นั่นคือข้อผูกพัน: กำหนดเฮดเดอร์และตัวแปรเพียงครั้งเดียว และการรันสถานการณ์ทุกครั้งผ่าน CLI จะนำค่าเหล่านั้นไปด้วย สำหรับการตั้งค่าและรายละเอียดโทเค็น โปรดดู คู่มือการติดตั้ง Apidog CLI และสำหรับการเชื่อมต่อการรันเข้ากับระบบอัตโนมัติ คู่มือ Apidog CLI ใน GitHub Actions ของเราแสดงให้เห็นถึงขั้นตอนการทำงานทั้งหมด

คำถามที่พบบ่อย

พารามิเตอร์ส่วนกลางจะแทนที่เฮดเดอร์ที่ฉันตั้งค่าไว้บน Endpoint ที่เฉพาะเจาะจงหรือไม่?

ไม่ พารามิเตอร์ส่วนกลางมีความสำคัญต่ำกว่าพารามิเตอร์ระดับ Endpoint หากคำขอมีการกำหนดเฮดเดอร์ Authorization ของตัวเอง ค่าดังกล่าวจะถูกนำมาใช้และค่าส่วนกลางจะถูกละเว้นสำหรับคำขอนั้น ค่าส่วนกลางทำหน้าที่เป็นค่าเริ่มต้นของโปรเจกต์ โดยจะเติมเต็มในส่วนที่ Endpoint ยังไม่ได้กำหนดค่าของตัวเอง

ฉันควรเก็บโทเค็นจริงไว้ที่ใดเพื่อไม่ให้ปรากฏเป็นข้อความธรรมดา?

ใช้ตัวแปรสภาพแวดล้อมหรือตัวแปรส่วนกลาง ไม่ใช่ค่าเริ่มต้นแบบดิบ ตั้งค่าเฮดเดอร์ส่วนกลางเป็น Bearer {{token}} และเก็บความลับจริงไว้ในตัวแปรที่สร้างผ่านไอคอนสภาพแวดล้อม เอกสารแนะนำให้ใช้ตัวแปรหรือวิธีการที่ปลอดภัยสำหรับข้อมูลที่ละเอียดอ่อนโดยเฉพาะ เพื่อไม่ให้โทเค็นถูกเก็บไว้ในบรรทัดเดียวกัน คู่มือของเราเกี่ยวกับการ ดึงตัวแปรด้วย JSONPath ครอบคลุมวิธีการจับโทเค็นจากการตอบสนองการเข้าสู่ระบบและนำกลับมาใช้ซ้ำในลักษณะเดียวกัน

ฉันจะยืนยันได้อย่างไรว่าเฮดเดอร์ส่วนกลางถูกส่งออกไปจริง?

ส่งคำขอใดๆ จากนั้นเปิดแท็บ Actual Request ในคอนโซลการตอบกลับ มันจะแสดงคำขอตามที่ถูกส่งออกไปจริง โดยมี {{token}} และตัวแปรอื่นๆ ถูกแทนที่ด้วยค่าของมันแล้ว หากเฮดเดอร์ของคุณปรากฏอยู่ที่นั่น แสดงว่ามันถูกส่งออกไปแล้ว

ฉันสามารถเพิ่มเฮดเดอร์เริ่มต้นให้กับโฟลเดอร์เดียวเท่านั้นแทนที่จะเป็นทั้งโปรเจกต์ได้หรือไม่?

ได้ แต่ไม่ใช่ผ่านฟิลด์การตั้งค่า เนื่องจาก Apidog ไม่มี UI เฮดเดอร์โฟลเดอร์ในตัว ให้เพิ่มสคริปต์ก่อนคำขอในโฟลเดอร์โดยใช้ pm.request.headers.add({ key, value }) และทุกคำขอในโฟลเดอร์นั้นจะได้รับเฮดเดอร์ ในขณะที่ส่วนที่เหลือของโปรเจกต์จะไม่ได้รับ

ฉันจำเป็นต้องมีแผนแบบชำระเงินเพื่อใช้พารามิเตอร์ส่วนกลางหรือตัวแปรสภาพแวดล้อมหรือไม่?

เอกสารประกอบสำหรับคุณสมบัติเหล่านี้ไม่ได้ระบุข้อจำกัดระดับ (tier) ใดๆ พารามิเตอร์ส่วนกลาง, ตัวแปรสภาพแวดล้อม และสคริปต์ก่อนคำขอระดับโฟลเดอร์ ล้วนถูกบันทึกไว้โดยไม่มีการแบ่งแยกระหว่างฟรีกับแบบชำระเงิน

สรุป

การตั้งค่าเฮดเดอร์ในทุกคำขอเป็นงานที่ทำเพียงครั้งเดียวใน Apidog: กำหนดเฮดเดอร์เป็นพารามิเตอร์ส่วนกลางภายใต้ Environment Management, อ้างอิงความลับเป็นตัวแปร {{token}} เพื่อให้มันไม่อยู่ในข้อความธรรมดา และยืนยันว่ามันถูกส่งออกไปพร้อมกับแท็บ Actual Request เมื่อคุณต้องการเฮดเดอร์ในโฟลเดอร์เดียวเท่านั้น สคริปต์ก่อนคำขอจะช่วยได้ ในการทำตามในโปรเจกต์ของคุณเอง ดาวน์โหลด Apidog และตั้งค่าเฮดเดอร์ส่วนกลางแรกของคุณได้ฟรี ไม่มีค่าใช้จ่าย

button

ฝึกการออกแบบ API แบบ Design-first ใน Apidog

ค้นพบวิธีที่ง่ายขึ้นในการสร้างและใช้ API