---
sourceDocument: 호주 API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# NowAPIService 인터페이스 - Android

# NowAPIService 인터페이스 - Android {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 2분

NowAPIService 인터페이스는 지정된 ServiceNow REST API에서 요청을 수행하는 기능을 제공합니다.  
주:  
게스트 사용자는 액세스 중인 REST API가 게스트 사용자용으로 구성된 경우에만 NowAPIService 인터페이스에서 작동합니다.  
{#NowAPIServiceAndroidInterface__table_vx2_klw_5pb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 구성 | [NowService구성](https://servicenow-prod.fluidtopics.net/NtuWyYK4RVRmN~CPbUxQYw "NowServiceConfiguration 클래스를 사용하면 기능 서비스의 인스턴스 URL 및 패키지 이름을 구성할 ServiceNow 수 있습니다.") | 프로토콜과 연결할 서비스 구성입니다. |
[표 1. 속성]

{#NowAPIServiceAndroidInterface__table_vx2_klw_5pb}

## NowAPIService - data(엔드포인트: NowAPIService.Endpoint, queryParams: QueryParams, 헤더: 헤더, 본문: 문자열) {#ariaid-title2}

지정된 ServiceNow 인스턴스에서 지정된 REST API를 호출합니다.
{#NAPIServ-data_S_S_S_S__table_u3p_dkt_4pb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 엔드포인트 | NowAPIService.Endpoint | 호출할 REST 엔드포인트입니다. |
| queryParams | QueryParams | 옵션입니다. REST 호출에 전달할 쿼리 매개변수를 포함하는 쿼리 매개변수 객체입니다. 기본값: null |
| 헤더 | 헤더 | 옵션입니다. REST 호출에 전달할 헤더가 포함된 헤더 객체입니다. 기본값: null |
| 본문 | 문자열 | 옵션입니다. REST 호출에 전달할 요청 본문과 콘텐츠 유형이 포함된 객체입니다. 기본값: null |
[표 2. 매개변수]

{#NAPIServ-data_S_S_S_S__table_u3p_dkt_4pb} {#NAPIServ-data_S_S_S_S__table_v3p_dkt_4pb__entry__2}

| 유형 | 설명 |
|-|-|
| [호출](https://servicenow-prod.fluidtopics.net/BN_RUz24goZYtkdnEIbMCQ#CallAndroidInterface "호출 인터페이스는 처리를 위해 준비된 요청을 나타냅니다.")\<[ByteArray](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte-array/)\> | 호출된 REST 엔드포인트에서 결과를 반환합니다. |
[표 3. 반환]

{#NAPIServ-data_S_S_S_S__table_v3p_dkt_4pb}  
<br />

    suspend fun loadCases(): List<CaseItem> = withContext(Dispatchers.IO) {
      val apiService = nowServiceManager.getNowAPIService()

      val result = runCatching {
        val response = apiService.data(NowAPIService.Endpoint(
          relativePath = CASES_API,
          requestMethod = HttpMethod.GET,
          requireAuth = true)
        ).execute()

        val byteArray = response.body ?: throw Exception("Null Result")
        val buffer = Buffer()
        val reader = JsonReader.of(buffer.write(byteArray))
        val listType = Types.newParameterizedType(
          List::class.java,
          CaseItem::class.java
        )

        val resultType = Types.newParameterizedType(
          ResultResponse::class.java,
          listType
        )
        val adapter = moshi.adapter<ResultResponse<List<CaseItem>>>(resultType)
        adapter.fromJson(reader)
      }

      if (result.isSuccess) {
          result.getOrNull()?.result ?: throw Exception("Cases not in response")
      } else {
          throw result.exceptionOrNull() ?: Exception("Error Cases")
      }
    }