ZEPETO.Multiplay.HttpService

ประเภท คำอธิบาย httpcontenttype /#httpcontenttype การแจกแจงค่าคงที่ที่ระบุ content type ของ http httpbodytype /#httpbodytype ชื่อแทนชนิดข้อมูลสำหรับเนื้อหา http body ซึ่งอาจเป็นข้อความธรรมดาหรืออ็อบเจกต์คีย์ ค่า httpheader /#httpheader ชื่อแทนชนิดข้อมูลสำหรับ http header ซึ่งแทนอ็อบเจกต์คีย์ ค่า httperrortype /#httperrortype การแจกแจงค่าคงที่ที่ระบุสาเหตุความล้มเหลวของคำขอ http httperror /#httperror แทนข้อผิดพลาดที่เกิดขึ้นระหว่างคำขอ http httpresponse /#httpresponse แทน http response httpservice /#httpservice httpservice มี api สำหรับสร้างการเชื่อมต่อ http กับบริการเว็บภายนอกและส่งคำขอ โปรดใช้โปรโตคอล https โดย http รองรับเฉพาะในสภาพแวดล้อมสำหรับการพัฒนาเท่านั้น คำขอถูกจำกัดไว้ที่พอร์ต 80 และ 443 ขนาดสูงสุดของ body ในคำขอและการตอบกลับคือ 16kb โปรดรักษาจำนวนคำขอต่อนาทีให้ต่ำกว่า 500 เพื่อหลีกเลี่ยงข้อจำกัดที่อาจเกิดขึ้นกับบริการ world อันเนื่องมาจากคำขอที่มากเกินไป คำขอจะล้มเหลวหากบริการเว็บภายนอกไม่ตอบกลับภายใน 5 วินาที โปรดตรวจสอบว่า content type ในเฮดเดอร์การตอบกลับตรงกับค่าที่กำหนดไว้ใน enum httpcontenttype เพื่อป้องกันไม่ให้คำขอล้มเหลว เนื่องจากคำขอเว็บอาจล้มเหลวได้จากหลายสาเหตุ จึงแนะนำให้เขียนโค้ดในเชิงป้องกัน httpcontenttype enum การแจกแจงค่าคงที่ที่ระบุ content type ของ http ชื่อ ค่า คำอธิบาย applicationjson "application/json" แทน content type แบบ application/json applicationxml "application/xml" แทน content type แบบ application/xml applicationurlencoded "application/x www form urlencoded" แทน content type แบบ application/x www form urlencoded textplain "text/plain" แทน content type แบบ text/plain textxml "text/xml" แทน content type แบบ text/xml httpbodytype delegate ชื่อแทนชนิดข้อมูลสำหรับเนื้อหา http body ซึ่งอาจเป็นข้อความธรรมดาหรืออ็อบเจกต์คีย์ ค่า string | { \[key string] any; } httpheader delegate ชื่อแทนชนิดข้อมูลสำหรับ http header ซึ่งแทนอ็อบเจกต์คีย์ ค่า { \[key string] string | number; } httperrortype enum การแจกแจงค่าคงที่ที่ระบุสาเหตุความล้มเหลวของคำขอ http ชื่อ ค่า คำอธิบาย err access denied "err access denied" ข้อผิดพลาด การเข้าถึงถูกปฏิเสธ err length required "err length required" ข้อผิดพลาด ต้องระบุความยาว httperror interface · extends error แทนข้อผิดพลาดที่เกิดขึ้นระหว่างคำขอ http พร็อพเพอร์ตี้ ชื่อ ประเภท คำอธิบาย message string ข้อความแสดงข้อผิดพลาด code string รหัสข้อผิดพลาดที่กำหนดเป็นค่าจาก enum httperrortype httpresponse interface แทน http response พร็อพเพอร์ตี้ ชื่อ ประเภท คำอธิบาย statuscode number รหัสสถานะของการตอบกลับ โดยทั่วไป 200 หมายถึงคำขอสำเร็จ statustext string ข้อความสถานะที่สอดคล้องกับรหัสสถานะ โดยทั่วไป "ok" หมายถึงคำขอสำเร็จ response string เนื้อหา body ของการตอบกลับ http ซึ่งรูปแบบอาจแตกต่างกันไปตาม content type ของการตอบกลับ แนะนำให้ใช้ parser ที่เหมาะสมกับ content type ที่ได้รับ httpservice interface httpservice มี api สำหรับสร้างการเชื่อมต่อ http กับบริการเว็บภายนอกและส่งคำขอ โปรดใช้โปรโตคอล https โดย http รองรับเฉพาะในสภาพแวดล้อมสำหรับการพัฒนาเท่านั้น คำขอถูกจำกัดไว้ที่พอร์ต 80 และ 443 ขนาดสูงสุดของ body ในคำขอและการตอบกลับคือ 16kb โปรดรักษาจำนวนคำขอต่อนาทีให้ต่ำกว่า 500 เพื่อหลีกเลี่ยงข้อจำกัดที่อาจเกิดขึ้นกับบริการ world อันเนื่องมาจากคำขอที่มากเกินไป คำขอจะล้มเหลวหากบริการเว็บภายนอกไม่ตอบกลับภายใน 5 วินาที โปรดตรวจสอบว่า content type ในเฮดเดอร์การตอบกลับตรงกับค่าที่กำหนดไว้ใน enum httpcontenttype เพื่อป้องกันไม่ให้คำขอล้มเหลว เนื่องจากคำขอเว็บอาจล้มเหลวได้จากหลายสาเหตุ จึงแนะนำให้เขียนโค้ดในเชิงป้องกัน เมธอด getasync getasync(url string, headers? httpheader) → promise\<httpresponse> ดำเนินการคำขอ http get แบบอะซิงโครนัส โดยจะโยน httperror พารามิเตอร์ ประเภท คำอธิบาย url string ที่อยู่เว็บที่จะส่งคำขอไป headers (ไม่บังคับ) httpheader /#httpheader เฮดเดอร์ของคำขอ http (ไม่บังคับ) ค่าที่คืนกลับ promise\<httpresponse> — promise ที่ resolve พร้อมอ็อบเจกต์ httpresponse เมื่อดำเนินการเสร็จสิ้น postasync postasync(url string, body httpbodytype, headers? httpheader) → promise\<httpresponse> ดำเนินการคำขอ http post แบบอะซิงโครนัส โดยจะโยน httperror พารามิเตอร์ ประเภท คำอธิบาย url string ที่อยู่เว็บที่จะส่งคำขอไป body httpbodytype /#httpbodytype เนื้อหา body ของคำขอ headers (ไม่บังคับ) httpheader /#httpheader เฮดเดอร์ของคำขอ http (ไม่บังคับ) ค่าที่คืนกลับ promise\<httpresponse> — promise ที่ resolve พร้อมอ็อบเจกต์ httpresponse เมื่อดำเนินการเสร็จสิ้น postasync postasync(url string, body httpbodytype, httpcontenttype httpcontenttype, headers? httpheader) → promise\<httpresponse> ดำเนินการคำขอ http post แบบอะซิงโครนัส โดยจะโยน httperror เมื่อใช้ signature นี้ หากคุณเพิ่ม 'content type' ลงใน headers ค่าดังกล่าวจะถูกเขียนทับด้วยค่าที่ระบุใน httpcontenttype พารามิเตอร์ ประเภท คำอธิบาย url string ที่อยู่เว็บที่จะส่งคำขอไป body httpbodytype /#httpbodytype เนื้อหา body ของคำขอ httpcontenttype httpcontenttype /#httpcontenttype ระบุเฮดเดอร์ content type ของคำขอ headers (ไม่บังคับ) httpheader /#httpheader เฮดเดอร์ของคำขอ http (ไม่บังคับ) ค่าที่คืนกลับ promise\<httpresponse> — promise ที่ resolve พร้อมอ็อบเจกต์ httpresponse เมื่อดำเนินการเสร็จสิ้น