--- title: ZEPETO.Multiplay.HttpService slug: world-sdk-guide-kr/zepetomultiplayhttpservice docTags: createdAt: 2026-09-04T05:16:15.104Z --- | 형식 | 설명 | | ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [HttpContentType](./#httpcontenttype) | HTTP Content-Type을 지정하는 상수의 열거형입니다. | | [HttpBodyType](./#httpbodytype) | HTTP 본문 내용의 타입 별칭이며, 일반 텍스트 또는 키-값 객체를 사용할 수 있습니다. | | [HttpHeader](./#httpheader) | HTTP 헤더의 타입 별칭이며, 키-값 객체를 나타냅니다. | | [HttpErrorType](./#httperrortype) | HTTP 요청 실패 원인을 지정하는 상수의 열거형입니다. | | [HttpError](./#httperror) | HTTP 요청 중 발생한 오류를 나타냅니다. | | [HttpResponse](./#httpresponse) | HTTP 응답을 나타냅니다. | | [HttpService](./#httpservice) | `HttpService`는 외부 웹 서비스와 HTTP 연결을 맺고 요청을 보내기 위한 API를 제공합니다. - HTTPS 프로토콜을 사용해야 합니다. HTTP는 개발 환경에서만 지원됩니다. - 요청은 80번과 443번 포트로 제한됩니다. - 요청 본문과 응답 본문의 최대 크기는 16KB입니다. - 요청이 과도할 경우 World 서비스에 제한이 걸릴 수 있으므로, 분당 요청 수를 500회 미만으로 유지하세요. - 외부 웹 서비스가 5초 이내에 응답하지 않으면 요청이 실패합니다. - 요청 실패를 방지하려면 응답 헤더의 Content-Type이 `HttpContentType` 열거형에 정의된 값과 일치하는지 확인하세요. - 웹 요청은 여러 원인으로 실패할 수 있으므로 방어적으로 코드를 작성하는 것을 권장합니다. | ## HttpContentType `enum` HTTP Content-Type을 지정하는 상수의 열거형입니다. | 이름 | 값 | 설명 | | --------------------- | ----------------------------------- | ------------------------------------------------ | | ApplicationJson | "application/json" | application/json 콘텐츠 타입을 나타냅니다. | | ApplicationXml | "application/xml" | application/xml 콘텐츠 타입을 나타냅니다. | | ApplicationUrlEncoded | "application/x-www-form-urlencoded" | application/x-www-form-urlencoded 콘텐츠 타입을 나타냅니다. | | TextPlain | "text/plain" | text/plain 콘텐츠 타입을 나타냅니다. | | TextXml | "text/xml" | text/xml 콘텐츠 타입을 나타냅니다. | ## HttpBodyType `delegate` HTTP 본문 내용의 타입 별칭이며, 일반 텍스트 또는 키-값 객체를 사용할 수 있습니다. `string | { [key: string]: any; }` ## HttpHeader `delegate` HTTP 헤더의 타입 별칭이며, 키-값 객체를 나타냅니다. `{ [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` | `HttpErrorType` 열거형의 값으로 정의된 오류 코드입니다. | ## HttpResponse `interface` HTTP 응답을 나타냅니다. ### 속성 | 이름 | 형식 | 설명 | | ---------- | -------- | ------------------------------------------------------------------------------------------------ | | statusCode | `number` | 응답의 상태 코드입니다. 일반적으로 200은 요청 성공을 의미합니다. | | statusText | `string` | 상태 코드에 대응하는 상태 메시지입니다. 일반적으로 "OK"는 요청 성공을 의미합니다. | | response | `string` | HTTP 응답의 본문입니다. 응답의 Content-Type에 따라 형식이 달라질 수 있습니다. 수신한 Content-Type에 맞는 적절한 파서를 사용하는 것을 권장합니다. | ## HttpService `interface` `HttpService`는 외부 웹 서비스와 HTTP 연결을 맺고 요청을 보내기 위한 API를 제공합니다. - HTTPS 프로토콜을 사용해야 합니다. HTTP는 개발 환경에서만 지원됩니다. - 요청은 80번과 443번 포트로 제한됩니다. - 요청 본문과 응답 본문의 최대 크기는 16KB입니다. - 요청이 과도할 경우 World 서비스에 제한이 걸릴 수 있으므로, 분당 요청 수를 500회 미만으로 유지하세요. - 외부 웹 서비스가 5초 이내에 응답하지 않으면 요청이 실패합니다. - 요청 실패를 방지하려면 응답 헤더의 Content-Type이 `HttpContentType` 열거형에 정의된 값과 일치하는지 확인하세요. - 웹 요청은 여러 원인으로 실패할 수 있으므로 방어적으로 코드를 작성하는 것을 권장합니다. ### 메서드 ### getAsync `getAsync(url: string, headers?: HttpHeader) → Promise` HTTP GET 요청을 비동기로 수행합니다. `HttpError`를 발생시킵니다. | 매개변수 | 형식 | 설명 | | --------------- | --------------------------- | ---------------------- | | url | `string` | 요청을 보낼 웹 주소입니다. | | headers (선택 사항) | [HttpHeader](./#httpheader) | HTTP 요청 헤더입니다. (선택 사항) | **반환값:** `Promise` — 작업 완료 시 `HttpResponse` 객체와 함께 이행되는 `Promise`입니다. ### postAsync `postAsync(url: string, body: HttpBodyType, headers?: HttpHeader) → Promise` HTTP POST 요청을 비동기로 수행합니다. `HttpError`를 발생시킵니다. | 매개변수 | 형식 | 설명 | | --------------- | ------------------------------- | ---------------------- | | url | `string` | 요청을 보낼 웹 주소입니다. | | body | [HttpBodyType](./#httpbodytype) | 요청 본문 내용입니다. | | headers (선택 사항) | [HttpHeader](./#httpheader) | HTTP 요청 헤더입니다. (선택 사항) | **반환값:** `Promise` — 작업 완료 시 `HttpResponse` 객체와 함께 이행되는 `Promise`입니다. ### postAsync `postAsync(url: string, body: HttpBodyType, httpContentType: HttpContentType, headers?: HttpHeader) → Promise` HTTP POST 요청을 비동기로 수행합니다. `HttpError`를 발생시킵니다. 이 시그니처를 사용할 때 headers에 'Content-Type'을 추가하면, `httpContentType`에 지정한 값으로 덮어써집니다. | 매개변수 | 형식 | 설명 | | --------------- | ------------------------------------- | --------------------------- | | url | `string` | 요청을 보낼 웹 주소입니다. | | body | [HttpBodyType](./#httpbodytype) | 요청 본문 내용입니다. | | httpContentType | [HttpContentType](./#httpcontenttype) | 요청의 Content-Type 헤더를 지정합니다. | | headers (선택 사항) | [HttpHeader](./#httpheader) | HTTP 요청 헤더입니다. (선택 사항) | **반환값:** `Promise` — 작업 완료 시 `HttpResponse` 객체와 함께 이행되는 `Promise`입니다.