สำหรับ API ของที่นี่ก็จะเน้นพวกของเล่นเพื่อซัพพอร์ตสตรีมเมอร์หรือคนที่ต้องการจะ Host Event ต่างๆนะครับ มักจะเป็นการเรียก API เพื่อสุ่มเอาข้อมูลออกมา 1 รายการ ตามเงื่อนไขที่ Query เข้าไปนะครับ มีการเรียกข้อมูลอย่างไร อะไรบ้าง ใช้งานอย่างไร เราไปดูกันครับ
ถ้าเกิดว่ามี API ตัวไหนใช้งานไม่ได้ ทำงานผิดปกติ สามารถแจ้งได้ตามช่องทางติดต่อในหน้า Contact ได้เลยครับ
การสุ่มเมนูอาหาร จะสุ่มจากการยิง Request ไปที่ https://api.lucian.solutions/api.foodmenu.php
ครับ โดยในส่วนของ body จะ output ออกมาเป็น Text ให้เอาไปใช้ต่อได้เลย
โดยที่หลักๆจะมีอาหารอยู่ 4 ประเภท
ข้าว
เมนูเส้น/ก๋วยเตี๋ยว
ซุป/ต้ม/แกง
อื่นๆ
จริงๆแล้ว เราสามารถเลือกประเภทให้อยู่ในประเภทเดียวได้โดยการเพิ่ม query ได้ และยังสามารถฟิลเตอร์ให้ออกเฉพาะเมนูฮาลาลได้ด้วย การ query นั้น จะมี parameter อยู่สองตัว คือ args1
และ args2
เราสามารถใส่ค่าให้เลือกประเภทได้ผ่านทางสองค่านี้ โดยที่ไม่สนว่าเราจะใส่ช่องไหน (แต่ใส่ประเภทอาหารทั้งสองค่า จะเอาจาก args2
เป็นหลัก)
ดังนั้นแล้ว URL เต็มๆ จะมีค่าประมาณว่า
https://api.lucian.solutions/api.foodmenu.php?args1=example&args2=example
โดยที่ค่าที่ส่งไป (ที่จะเปลี่ยนจาก example) สามารถเปลี่ยนค่าได้ดังนี้
rice
ไว้สุ่มเมนูข้าว
noodles
ไว้สุ่มเมนูเส้น/ก๋วยเตี๋ยว
soup
ไว้สุ่มเมนูซุป/ต้ม/แกง
others
ไว้สุ่มเมนูอื่นๆนอกจากที่ระบุ เช่น สเต๊ก ส้มตำ พิซซ่า ฯลฯ
halal
ไว้กรองเฉพาะเมนูฮาลาล
ตัวอย่างที่ถูกต้อง จะเป็นประมาณว่า
https://api.lucian.solutions/api.foodmenu.php?args1=noodles&args2=halal
ซึ่งจะเป็นการเลือกเมนูเส้นที่ฮาลาล หรืออีกตัวอย่าง เช่น
https://api.lucian.solutions/api.foodmenu.php?args1=soup
ซึ่งจะเป็นการเลือกเมนูซุป/ต้ม/แกง โดยใส่แค่ค่าเดียว หรือจะเป็น
https://api.lucian.solutions/api.foodmenu.php
ก็ได้ ซึ่งจะเป็นการสุ่มจากทุกอย่างในรายการ ไม่มีการกรองครับผม
จริงๆมันมีการใส่ parameter อีกแบบด้วยครับ แต่ไม่แนะนำให้ใช้ มันเกิดมาเพื่อซัพพอร์ตกับการเรียก command ผ่านแชทสตรีมเมอร์ครับ โดยจะใช้ parameter fullarg
ซึ่งจะเป็นการเอาข้อความแชทตรงนั้นทั้งก้อนมาตัดคำด้วย whitespace หรือเว้นวรรค เช่น !foodmenu halal soup
มันก็จะ URL encode มาตัดคำ เอา parameter 2 ตัว
(ซึ่งจะมีหรือไม่มีก็ได้) มาใส่เป็น query เหมือนด้านบนครับ โดยที่ตัวอย่างการพิมพ์รับ parameter ด้วย chatbot ก็จะประมาณว่า
${customapi.https://api.lucian.solutions/api.foodmenu.php?fullarg=${queryescape ${0:}}}
${customapi.https://api.lucian.solutions/api.foodmenu.php?fullarg=${queryescape ${0:}}}
$(urlfetch https://api.lucian.solutions/api.foodmenu.php?fullarg=$(querystring food $(1) $(2)))
$(urlfetch https://api.lucian.solutions/api.foodmenu.php?fullarg=$(querystring food $(1) $(2)))
การสุ่มเมนูเครื่องดื่ม เช่นเดียวกับอาหารครับ จะสุ่มจากการยิง Request ไปที่ https://api.lucian.solutions/api.drinksmenu.php
ครับ โดยในส่วนของ body จะ output ออกมาเป็น Text ให้เอาไปใช้ต่อได้เลย
โดยที่หลักๆจะมีเครื่องดื่มอยู่ 5 ประเภท
กาแฟและนม (เมนูที่ปกติจะสั่งได้ที่ร้านกาแฟ)
ชา (และน้ำสมุนไพรอื่นๆ)
น้ำผลไม้หรือผลไม้ปั่น
น้ำอัดลม อิตาเลียนโซดา และเครื่องดื่มชูกำลัง
เครื่องดื่มแอลกอฮอล์
เราสามารถเลือกประเภทให้อยู่ในประเภทเดียวได้โดยการเพิ่ม query ได้ ซึ่งปกติการสุ่มจะไม่นับเครื่องดื่มแอลกอฮอล์ด้วยถ้าไม่ได้ระบุว่าจะสุ่มแอลกอฮอล์ โดยถ้าจะให้สุ่มทุกอย่างรวมแอลกอฮอล์ด้วย จะใข้ query partymode
ครับ
โดยการ query นั้น จะมี parameter อยู่หนึ่งตัว คือ args1
เราสามารถใส่ค่าให้เลือกประเภทได้ผ่านทางค่านี้
ดังนั้นแล้ว URL เต็มๆ จะมีค่าประมาณว่า
https://api.lucian.solutions/api.drinksmenu.php?args1=example
โดยที่ค่าที่ส่งไป (ที่จะเปลี่ยนจาก example) สามารถเปลี่ยนค่าได้ดังนี้
coffee
ไว้สุ่มเมนูร้านกาแฟ
tea
ไว้สุ่มเมนูชาและสมุนไพร
juice
ไว้สุ่มเมนูน้ำผลไม้หรือผลไม้ปั่น
soda
ไว้สุ่มเมนูน้ำอัดลม
alcohol
ไว้สุ่มเมนูเครื่องดื่มแอลกอฮอล์
partymode
ไว้สำหรับนับเครื่องดื่มแอลกอฮอล์ในการสุ่มรวมด้วย
ตัวอย่างที่ถูกต้อง จะเป็นประมาณว่า
https://api.lucian.solutions/api.drinksmenu.php?args1=soda
ซึ่งจะเป็นการเลือกเมนูน้ำอัดลม หรืออีกตัวอย่าง เช่น
https://api.lucian.solutions/api.drinksmenu.php?args1=partymode
ซึ่งจะเป็นการสุ่มทุกอย่าง รวมเครื่องดื่มแอลกอฮอล์ด้วย หรือจะเป็น
https://api.lucian.solutions/api.drinksmenu.php
ก็ได้ ซึ่งจะไม่มีการสุ่มจากเครื่องดื่มแอลกอฮอล์ในรายการครับผม
จริงๆมันมีการใส่ parameter อีกแบบเพื่อซัพพอร์ตกับการเรียก command ผ่านแชทสตรีมเมอร์เหมือนสุ่มเมนูอาหารครับ โดยจะใช้ parameter fullarg
ซึ่งจะเป็นการเอาข้อความแชทตรงนั้นทั้งก้อนมาตัดคำด้วย whitespace หรือเว้นวรรค เช่น !drinksmenu coffee
มันก็จะ URL encode มาตัดคำ เอา parameter
(ซึ่งจะมีหรือไม่มีก็ได้) มาใส่เป็น query เหมือนด้านบนครับ โดยที่ตัวอย่างการพิมพ์รับ parameter ด้วย chatbot ก็จะประมาณว่า
${customapi.https://api.lucian.solutions/api.drinksmenu.php?fullarg=${queryescape ${0:}}}
${customapi.https://api.lucian.solutions/api.drinksmenu.php?fullarg=${queryescape ${0:}}}
$(urlfetch https://api.lucian.solutions/api.drinksmenu.php?fullarg=$(querystring drinks $(1)))
$(urlfetch https://api.lucian.solutions/api.drinksmenu.php?fullarg=$(querystring drinks $(1)))