--- title: ZEPETO.Multiplay.HttpService slug: world-sdk-guide-id/zepetomultiplayhttpservice docTags: createdAt: 2026-09-04T05:15:02.631Z --- | Tipe | Deskripsi | | ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [HttpContentType](./#httpcontenttype) | Enumerasi konstanta yang menentukan Content-Type HTTP. | | [HttpBodyType](./#httpbodytype) | Alias tipe untuk konten HTTP Body, yang dapat berupa teks biasa atau objek key-value. | | [HttpHeader](./#httpheader) | Alias tipe untuk HTTP Header, yang merepresentasikan objek key-value. | | [HttpErrorType](./#httperrortype) | Enumerasi konstanta yang menentukan penyebab kegagalan permintaan HTTP. | | [HttpError](./#httperror) | Merepresentasikan error yang terjadi selama permintaan HTTP. | | [HttpResponse](./#httpresponse) | Merepresentasikan HTTP Response. | | [HttpService](./#httpservice) | `HttpService` menyediakan API untuk membangun koneksi HTTP dengan layanan web eksternal dan mengirim permintaan. - Pastikan menggunakan protokol HTTPS; HTTP hanya didukung di lingkungan pengembangan. - Permintaan dibatasi pada port 80 dan 443. - Ukuran maksimum body permintaan dan respons adalah 16KB. - Jaga jumlah permintaan tetap di bawah 500 per menit untuk menghindari kemungkinan pembatasan pada layanan World akibat permintaan yang berlebihan. - Permintaan akan gagal jika layanan web eksternal tidak merespons dalam 5 detik. - Pastikan Content-Type pada header respons sesuai dengan nilai yang didefinisikan pada enum `HttpContentType` untuk mencegah kegagalan permintaan. - Karena permintaan web dapat gagal karena berbagai alasan, disarankan untuk menulis kode secara defensif. | ## HttpContentType `enum` Enumerasi konstanta yang menentukan Content-Type HTTP. | Nama | Nilai | Deskripsi | | --------------------- | ----------------------------------- | ----------------------------------------------------------------- | | ApplicationJson | "application/json" | Merepresentasikan content type application/json. | | ApplicationXml | "application/xml" | Merepresentasikan content type application/xml. | | ApplicationUrlEncoded | "application/x-www-form-urlencoded" | Merepresentasikan content type application/x-www-form-urlencoded. | | TextPlain | "text/plain" | Merepresentasikan content type text/plain. | | TextXml | "text/xml" | Merepresentasikan content type text/xml. | ## HttpBodyType `delegate` Alias tipe untuk konten HTTP Body, yang dapat berupa teks biasa atau objek key-value. `string | { [key: string]: any; }` ## HttpHeader `delegate` Alias tipe untuk HTTP Header, yang merepresentasikan objek key-value. `{ [key: string]: string | number; }` ## HttpErrorType `enum` Enumerasi konstanta yang menentukan penyebab kegagalan permintaan HTTP. | Nama | Nilai | Deskripsi | | --------------------- | ----------------------- | -------------------------- | | ERR\_ACCESS\_DENIED | "ERR\_ACCESS\_DENIED" | Error: Akses ditolak. | | ERR\_LENGTH\_REQUIRED | "ERR\_LENGTH\_REQUIRED" | Error: Panjang diperlukan. | ## HttpError `interface` · extends `Error` Merepresentasikan error yang terjadi selama permintaan HTTP. ### Properti | Nama | Tipe | Deskripsi | | ------- | -------- | ---------------------------------------------------------------------- | | message | `string` | Pesan error. | | code | `string` | Kode error yang didefinisikan sebagai nilai dari enum `HttpErrorType`. | ## HttpResponse `interface` Merepresentasikan HTTP Response. ### Properti | Nama | Tipe | Deskripsi | | ---------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | statusCode | `number` | Kode status dari respons. Umumnya, 200 menandakan permintaan berhasil. | | statusText | `string` | Pesan status yang sesuai dengan kode status. Umumnya, "OK" menandakan permintaan berhasil. | | response | `string` | Body dari respons HTTP, yang formatnya dapat berbeda-beda tergantung Content-Type respons. Disarankan menggunakan parser yang sesuai dengan Content-Type yang diterima. | ## HttpService `interface` `HttpService` menyediakan API untuk membangun koneksi HTTP dengan layanan web eksternal dan mengirim permintaan. - Pastikan menggunakan protokol HTTPS; HTTP hanya didukung di lingkungan pengembangan. - Permintaan dibatasi pada port 80 dan 443. - Ukuran maksimum body permintaan dan respons adalah 16KB. - Jaga jumlah permintaan tetap di bawah 500 per menit untuk menghindari kemungkinan pembatasan pada layanan World akibat permintaan yang berlebihan. - Permintaan akan gagal jika layanan web eksternal tidak merespons dalam 5 detik. - Pastikan Content-Type pada header respons sesuai dengan nilai yang didefinisikan pada enum `HttpContentType` untuk mencegah kegagalan permintaan. - Karena permintaan web dapat gagal karena berbagai alasan, disarankan untuk menulis kode secara defensif. ### Metode ### getAsync `getAsync(url: string, headers?: HttpHeader) → Promise` Menjalankan permintaan HTTP GET secara asinkron. Melempar `HttpError`. | Parameter | Tipe | Deskripsi | | ------------------ | --------------------------- | ---------------------------------------- | | url | `string` | Alamat web tujuan pengiriman permintaan. | | headers (opsional) | [HttpHeader](./#httpheader) | Header permintaan HTTP. (Opsional) | **Mengembalikan:** `Promise` — `Promise` yang selesai dengan objek `HttpResponse` setelah proses berakhir. ### postAsync `postAsync(url: string, body: HttpBodyType, headers?: HttpHeader) → Promise` Menjalankan permintaan HTTP POST secara asinkron. Melempar `HttpError`. | Parameter | Tipe | Deskripsi | | ------------------ | ------------------------------- | ---------------------------------------- | | url | `string` | Alamat web tujuan pengiriman permintaan. | | body | [HttpBodyType](./#httpbodytype) | Konten body permintaan. | | headers (opsional) | [HttpHeader](./#httpheader) | Header permintaan HTTP. (Opsional) | **Mengembalikan:** `Promise` — `Promise` yang selesai dengan objek `HttpResponse` setelah proses berakhir. ### postAsync `postAsync(url: string, body: HttpBodyType, httpContentType: HttpContentType, headers?: HttpHeader) → Promise` Menjalankan permintaan HTTP POST secara asinkron. Melempar `HttpError`. Saat menggunakan signature ini, jika Anda menambahkan 'Content-Type' ke headers, nilainya akan ditimpa oleh nilai yang ditentukan pada `httpContentType`. | Parameter | Tipe | Deskripsi | | ------------------ | ------------------------------------- | ----------------------------------------------- | | url | `string` | Alamat web tujuan pengiriman permintaan. | | body | [HttpBodyType](./#httpbodytype) | Konten body permintaan. | | httpContentType | [HttpContentType](./#httpcontenttype) | Menentukan header Content-Type pada permintaan. | | headers (opsional) | [HttpHeader](./#httpheader) | Header permintaan HTTP. (Opsional) | **Mengembalikan:** `Promise` — `Promise` yang selesai dengan objek `HttpResponse` setelah proses berakhir.