Httpie: คืออะไร ไคลเอนต์ HTTP สำหรับบรรทัดคำสั่ง

Httpie คืออะไรและแตกต่างจาก cURL อย่างไร

Httpie (หรือ HTTPie) เป็นยูทิลิตีบรรทัดคำสั่งที่เขียนด้วย Python ซึ่งช่วยให้การส่งคำขอ HTTP ง่ายกว่า cURL ความแตกต่างหลักคือไวยากรณ์ที่ใกล้เคียงภาษาธรรมชาติ: อาร์กิวเมนต์จะถูกคั่นด้วยช่องว่าง ส่วนหัวจะระบุด้วยเครื่องหมายทวิภาค และข้อมูล JSON จะระบุด้วยเครื่องหมายเท่ากับโดยไม่ต้องหนีเครื่องหมายคำพูด

การเปรียบเทียบ cURL และ Httpie

คำขอ POST เดียวกันใน cURL ต้องใช้แฟล็กอย่างน้อยสามตัว (-X, -H, -d) และการหนี JSON ด้วยตนเอง Httpie ทำสิ่งเดียวกันด้วยสามคำโดยไม่มีแฟล็ก โดยตั้งค่า Content-Type: application/json โดยอัตโนมัติและเน้นเอาต์พุต การตอบสนองจะถูกจัดรูปแบบด้วยการเยื้องและการเน้นไวยากรณ์โดยค่าเริ่มต้น

ไวยากรณ์ของคำขอใน Httpie

Httpie ใช้รูปแบบบรรทัดคำสั่งเดียวโดยไม่มีแฟล็กสำหรับพารามิเตอร์หลัก ระบุเมธอด HTTP เป็นอาร์กิวเมนต์แรก (GET, POST, PUT, DELETE, PATCH) และ URL เป็นอาร์กิวเมนต์ที่สอง หากละเมธอด Httpie จะเลือก GET (สำหรับคำขอที่ไม่มีเนื้อหา) หรือ POST (ที่มีเนื้อหา) โดยอัตโนมัติ

ประเภทของอาร์กิวเมนต์

• Header:Value — ส่วนหัวของคำขอที่มีเครื่องหมายทวิภาค ไม่มีช่องว่างหลังทวิภาค: Authorization:"Bearer token"
• key=value — ฟิลด์ออบเจกต์ JSON ในเนื้อหาคำขอ: name=John age=30
• key:=value — ค่า JSON ที่ไม่ใช่สตริง (ตัวเลข บูลีน อาร์เรย์): active:=true tags:=["dev","test"]
• key@file — โหลดค่าจากไฟล์: avatar@~/photo.jpg

Httpie จะกำหนดประเภทข้อมูลโดยอัตโนมัติ: หากส่ง key=value เนื้อหาจะถูกส่งเป็น JSON หากส่งข้อความดิบผ่าน --raw ข้อความนั้นจะถูกส่งเป็นข้อความธรรมดา รูปแบบ form-data จะเปิดใช้งานด้วยแฟล็ก -f

# คำขอ POST พร้อมข้อมูล JSON และส่วนหัว
http POST https://api.example.com/users \
    name="John Doe" \
    email="john@example.com" \
    role:="admin" \
    Authorization:"Bearer test123"

# การตอบสนองพร้อมการเน้นและ Pretty-print
HTTP/1.1 201 Created
Content-Type: application/json
{
    "id": 42,
    "name": "John Doe"
}

การทำงานกับ JSON และไฟล์

การซีเรียลไลซ์ JSON ใน Httpie ทำงานโดยอัตโนมัติ: ค่าที่ส่งเป็น key=value จะกลายเป็นฟิลด์สตริงของ JSON สำหรับตัวเลขและค่าบูลีน จะใช้ key:=value ออบเจกต์ซ้อนกันถูกสร้างด้วยเครื่องหมายจุด: address.city=Moscow

การอัปโหลดไฟล์และข้อมูลไบนารี

Httpie รองรับรูปแบบ multipart/form-data สำหรับการอัปโหลดไฟล์และข้อมูลผ่านไวยากรณ์ key@path หากจำเป็นต้องส่งเนื้อหาของไฟล์เป็นเนื้อหาดิบของคำขอ จะใช้การเปลี่ยนเส้นทางอินพุต: http POST example.com < file.json หากต้องการดาวน์โหลดการตอบสนองลงไฟล์ ให้ใช้แฟล็ก -d (download)

# ส่ง JSON จากไฟล์
http POST https://api.example.com/users < user.json

# อัปโหลดไฟล์ผ่าน multipart
http -f POST https://api.example.com/upload \
    photo@~/photo.jpg \
    description="Profile photo"

การจัดการเซสชันและคุกกี้

เซสชัน ใน Httpie จะเก็บสถานะระหว่างคำขอ: คุกกี้ ส่วนหัว และพารามิเตอร์การรับรองความถูกต้อง เซสชันถูกสร้างด้วยแฟล็ก --session=name ข้อมูลเซสชันจะถูกเก็บในไฟล์ JSON ในโฟลเดอร์ ~/.httpie/sessions/ เซสชันที่มีคำต่อท้าย :readonly จะไม่ได้รับการอัปเดตหลังคำขอ

ตัวอย่างการทดสอบเซสชัน

ขั้นแรก ส่งคำขอ POST ไปที่ /auth/login พร้อมข้อมูลประจำตัว — เซิร์ฟเวอร์ส่งคืนคุกกี้เซสชัน คำขอที่ตามมาทั้งหมดไปยังเอนด์พอยต์ที่ได้รับการป้องกันภายในเซสชันเดียวกันจะส่งคุกกี้ที่บันทึกไว้โดยอัตโนมัติ ซึ่งจำลองพฤติกรรมของเบราว์เซอร์เมื่อทดสอบ API ของแอปมือถือ

# ขั้นตอนที่ 1: การรับรองความถูกต้อง
http --session=app-test POST https://api.example.com/auth/login \
    username="dev" password="secret"

# ขั้นตอนที่ 2: คำขอพร้อมคุกกี้เซสชันที่บันทึกไว้
http --session=app-test GET https://api.example.com/users/me

การรับรองความถูกต้องและส่วนหัว

Httpie รองรับประเภทการรับรองความถูกต้องหลักทั้งหมดผ่านแฟล็ก: -a user:pass สำหรับ Basic Auth --auth-type=digest สำหรับ Digest --auth-type=bearer TOKEN สำหรับ Bearer Token ส่วนหัวแบบกำหนดเองจะถูกเพิ่มเป็น HeaderName:value ในตำแหน่งใดก็ได้ของคำสั่ง

OAuth 2.0 และ Bearer Token

ในการทดสอบ API ที่ใช้ OAuth 2.0 โทเค็นจะถูกส่งผ่านส่วนหัว Authorization Httpie ไม่จัดการวงจรชีวิตของโทเค็นในระดับคอร์ — สคริปต์ภายนอกเป็นผู้จัดการ คำสั่ง http --auth-type=bearer --auth="$TOKEN" GET https://api.example.com/resource เทียบเท่ากับการระบุส่วนหัวพร้อมโทเค็นอย่างชัดเจน

การใช้ Httpie ในสคริปต์ CI/CD

Httpie เหมาะอย่างยิ่งสำหรับไปป์ไลน์ CI/CD เนื่องจากไม่มีการพึ่งพา (ยกเว้น Python) และเอาต์พุตที่อ่านง่าย คำสั่งอ่านง่ายในล็อกโดยไม่ต้องแยกวิเคราะห์เพิ่มเติม เครื่องมือนี้ติดตั้งผ่าน pip และมีอยู่ใน Docker อิมเมจยอดนิยมทั้งหมด รวมถึง Alpine, Ubuntu และอิมเมจ CI อย่างเป็นทางการของ Jenkins และ GitLab สิ่งนี้ทำให้ Httpie เป็นตัวเลือกที่สะดวกสำหรับการทดสอบ REST API และไมโครเซอร์วิสโดยอัตโนมัติ

การตรวจสอบเอนด์พอยต์ health ระหว่างการ deploy

สถานการณ์ทั่วไปคือการตรวจสอบสถานะของ API หลังจากการ deploy แอปพลิเคชัน Httpie ส่งคำขอไปยังเอนด์พอยต์ health และสิ้นสุดด้วยโค้ดที่ไม่ใช่ศูนย์หากการตอบสนองไม่ตรงกับที่คาดไว้ แฟล็ก --check-status จะส่งคืนข้อผิดพลาดโดยอัตโนมัติสำหรับรหัสสถานะ >= 300

# ตรวจสอบ health ในสคริปต์ deploy
http --check-status GET https://api.staging.example.com/health
    status:="ok" && \
    echo "API ทำงานปกติ" || \
    echo "การตรวจสอบ API ล้มเหลว"

คุณสมบัติขั้นสูงและปลั๊กอินของ Httpie

Httpie รองรับปลั๊กอินผ่านระบบ Package Index ปลั๊กอินเพิ่มประเภทการรับรองความถูกต้อง รูปแบบการซีเรียลไลซ์ และการขนส่งใหม่ การติดตั้งทำผ่าน pip: pip install httpie-plugin-name หลังการติดตั้ง ปลั๊กอินจะเปิดใช้งานโดยอัตโนมัติเมื่อเริ่ม Httpie ครั้งถัดไป

ปลั๊กอิน Httpie ยอดนิยม

• httpie-jwt-auth — การรับและรีเฟรชโทเค็น JWT โดยอัตโนมัติผ่านกลไก refresh token
• httpie-oauth — รองรับ OAuth 2.0 Client Credentials และโฟลว์ Authorization Code พร้อมการแลกเปลี่ยนโค้ดเป็นโทเค็นโดยอัตโนมัติ
• httpie-editor — เปิดเนื้อหาคำขอในตัวแก้ไขข้อความ (vim, nano, VS Code) ก่อนส่ง
• httpie-image — แสดงภาพจากการตอบสนองในเทอร์มินัลโดยตรง (ต้องใช้ kitty หรือ iTerm2)

การเขียนสคริปต์และการแยกวิเคราะห์เอาต์พุต

Httpie รองรับการกรองแบบ jq ผ่านตัวเลือก --pretty=format และเอาต์พุตที่เข้ากันได้กับ cURL ผ่าน --print แฟล็ก --quiet จะปิดเอาต์พุตสีเพื่อให้อ่านง่ายขึ้นในล็อก CI สำหรับการประมวลผลการตอบสนองเชิงโปรแกรม ให้ใช้แฟล็ก --body ซึ่งจะแสดงเฉพาะเนื้อหาการตอบสนองโดยไม่มีส่วนหัว

# ดึงฟิลด์จากคำตอบ JSON ด้วย jq
http GET https://api.example.com/users/1 | jq '.name'

# แสดงเฉพาะเนื้อหาการตอบสนอง (ไม่มีส่วนหัว)
http --body GET https://api.example.com/health

# ส่งเป็นชุดพร้อมข้อมูลที่แตกต่างจากไฟล์
while read -r line; do
    http POST https://api.example.com/items $line
done < items.txt

รูปแบบเอาต์พุตและการปรับแต่ง

Httpie รองรับรูปแบบเอาต์พุตผ่านแฟล็ก --print: H (ส่วนหัวคำขอ), B (เนื้อหาคำขอ), h (ส่วนหัวการตอบสนอง), b (เนื้อหาการตอบสนอง) ชุด --print=hb จะแสดงเฉพาะส่วนหัวและเนื้อหาการตอบสนอง แฟล็ก --pretty=all เปิดการจัดรูปแบบสีพร้อมการเยื้อง

รูปแบบสีที่กำหนดเอง

Httpie รองรับการปรับแต่งผ่านตัวแปร HTTPIE_COLORS กำหนดค่าสีสำหรับ URL ส่วนหัว JSON และรหัสสถานะ มีธีมในตัว: autumn, borland, fruity, monokai, native, tango สำหรับเทอร์มินัลต่างๆ

เอาต์พุตในรูปแบบ JSON

สำหรับการประมวลผลเชิงโปรแกรม ให้ใช้ --body --pretty=none ซึ่งส่งคืน JSON ดิบ เอาต์พุตแบบกะทัดรัดมีประโยชน์สำหรับส่งต่อให้ jq, sed และตัวแยกวิเคราะห์อื่นๆ เมื่อทำงานอัตโนมัติในการทดสอบ API ในสคริปต์

รูปแบบเอาต์พุตและการปรับแต่งรูปลักษณ์

Httpie รองรับรูปแบบเอาต์พุตหลายรูปแบบผ่านแฟล็ก --print: H (ส่วนหัวคำขอ), B (เนื้อหาคำขอ), h (ส่วนหัวการตอบสนอง), b (เนื้อหาการตอบสนอง) ชุด --print=hb จะแสดงเฉพาะส่วนหัวและเนื้อหาการตอบสนอง ไม่รวมข้อมูลเมตาของการเชื่อมต่อ แฟล็ก --pretty=all เปิดการจัดรูปแบบสีพร้อมการเยื้องเพื่อความอ่านง่าย

รูปแบบสีที่กำหนดเอง

Httpie รองรับการปรับแต่งสีผ่านตัวแปรสภาพแวดล้อม HTTPIE_COLORS คุณสามารถกำหนดค่าสีสำหรับ URL ส่วนหัว คีย์ JSON และรหัสสถานะการตอบสนอง มีธีมในตัว: autumn, borland, fruity, monokai, native และ tango สำหรับประเภทเทอร์มินัลและความชอบส่วนบุคคลที่แตกต่างกัน

เอาต์พุตในรูปแบบ JSON โดยไม่มีการจัดรูปแบบ

สำหรับการประมวลผลเอาต์พุตเชิงโปรแกรม ให้ใช้ชุดแฟล็ก --body --pretty=none ซึ่งส่งคืน JSON ดิบโดยไม่มีสีและการเยื้อง เอาต์พุตแบบกะทัดรัดมีประโยชน์สำหรับส่งต่อให้ jq, sed และตัวแยกวิเคราะห์คอนโซลอื่นๆ เมื่อทำงานอัตโนมัติในการทดสอบ REST API ในสคริปต์เชลล์