---
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


---

# NowWeb API - iOS

# NowWeb API - iOS {#ariaid-title1}

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

NowWeb API는 NowWeb 서비스 인스턴스를 인스턴스화하는 데 사용할 수 있는 최상위 전역 API입니다.

## NowWeb - makeWebService(instanceUrl: URL) 비동기 throw {#ariaid-title2}

이전에 지정한 구성을 사용하여 NowWebService의 인스턴스를 작성합니다.
이 함수를 호출하기 전에 SDK를 초기화해야 하며, 그렇지 않으면 완료 블록이 `sdkNotConfigured` 오류와 함께 호출됩니다. SDK를 초기화하려면 원하는 구성으로 NowSDK.configure() 를 호출합니다.
{#NWeb-makeWebService-async_S__table_wct_ldx_kqb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| instanceUrl | URL | 서비스에서 웹 서비스에 액세스할 인스턴스의 ServiceNow URL입니다. |
[표 1. 매개변수]

{#NWeb-makeWebService-async_S__table_wct_ldx_kqb} {#NWeb-makeWebService-async_S__table_xct_ldx_kqb__entry__2}

| 유형 | 설명 |
|-|-|
| [Now웹 서비스](https://servicenow-prod.fluidtopics.net/U~iJ7vw~7iwRiSf35skPsw#NowWebServiceiOSAPI "NowWebService 클래스는 인스턴스에서 ServiceNow 웹 페이지를 찾아볼 수 있도록 하는 기능을 제공합니다.") | 성공하면 초기화된 NowWebService 객체를 반환합니다. |
| NowServiceError | 메서드가 실패하면 다음 오류 중 하나가 발생합니다. 가능한 값: * sdkNotConfigured * serviceConfiguration유효하지 않음 * serviceDisabled * serviceSettingsInvalid * serviceSettingsNotFound * serviceSettingsRetrievalFailed |
[표 2. 반환]

{#NWeb-makeWebService-async_S__table_xct_ldx_kqb}  
다음 코드 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다.

    do {
        let service = try await NowWeb.makeWebService(instanceUrl: instanceUrl)
        self.webService = service
    } catch {
        debugPrint("Web Service creation failed with error: \(error.localizedDescription)") 
    }

## NowWeb - makeWebService(instanceUrl: URL, 완성: @escaping ((결과\<NowWebService, NowServiceError\>) -\> 무효)) {#ariaid-title3}

이전에 지정한 구성을 사용하여 NowWebService의 인스턴스를 작성합니다. 완료되면 지정된 완성 핸들러를 호출합니다.
이 함수를 호출하기 전에 SDK를 초기화해야 하며, 그렇지 않으면 완료 블록이 `sdkNotConfigured` 오류와 함께 호출됩니다. SDK를 초기화하려면 원하는 구성으로 NowSDK.configure() 를 호출합니다.
{#NWeb-makeWebService_S_O__table_lry_wbx_kqb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| instanceUrl | URL | 서비스에서 웹 서비스에 액세스할 인스턴스의 ServiceNow URL입니다. |
| 완료 | @escaping((결과\<[NowWebService](https://servicenow-prod.fluidtopics.net/U~iJ7vw~7iwRiSf35skPsw#NowWebServiceiOSAPI "NowWebService 클래스는 인스턴스에서 ServiceNow 웹 페이지를 찾아볼 수 있도록 하는 기능을 제공합니다."), NowServiceError\>) -\> 무효) | 초기화된 `NowWebService` 인스턴스 또는 초기화 실패 이유를 나타내는 `NowServiceError`를 포함하는 `Result<NowWebService, NowServiceError>`와 함께 호출되는 완성 핸들러입니다. |
[표 3. 매개변수]

{#NWeb-makeWebService_S_O__table_lry_wbx_kqb} {#NWeb-makeWebService_S_O__table_mry_wbx_kqb__entry__2}

| 유형 | 설명 |
|-|-|
| 안 함 |   |
[표 4. 반환]

{#NWeb-makeWebService_S_O__table_mry_wbx_kqb}  
<br />

    func initializeNowSDK(userEmail: String) {
      currentUser = userEmail
      let sdkConfig = NowSDKConfiguration(authorizationProvider: self, permissionDelegate: self, logLevel: .debug)
            
      do {
          try NowSDK.configure(with: sdkConfig)
          configureAnalytics()
      } catch {
          debugPrint("Could not initialize NowSDK. Error: \(error.localizedDescription)")
      }
    }

## NowWeb - makeWebService(instanceUrl: URL) {#ariaid-title4}

이전에 지정한 구성을 사용하여 NowWebService의 인스턴스를 작성합니다.
주:  
이 방법은 더 이상 사용되지 않습니다. 대신 메서드의 async/await 구현을 사용해야 합니다.

이 함수를 호출하기 전에 SDK를 초기화해야 하며, 그렇지 않으면 완료 블록이 `sdkNotConfigured` 오류와 함께 호출됩니다. SDK를 초기화하려면 원하는 구성으로 NowSDK.configure() 를 호출합니다.
{#NWeb-makeWebService_S__table_wct_ldx_kqb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| instanceUrl | URL | 서비스에서 웹 서비스에 액세스할 인스턴스의 ServiceNow URL입니다. |
[표 5. 매개변수]

{#NWeb-makeWebService_S__table_wct_ldx_kqb} {#NWeb-makeWebService_S__table_xct_ldx_kqb__entry__2}

| 유형 | 설명 |
|-|-|
| AnyPublisher\<[NowWebService](https://servicenow-prod.fluidtopics.net/U~iJ7vw~7iwRiSf35skPsw#NowWebServiceiOSAPI "NowWebService 클래스는 인스턴스에서 ServiceNow 웹 페이지를 찾아볼 수 있도록 하는 기능을 제공합니다."), NowServiceError\> | 성공하면 초기화된 NowWebService 객체를 반환합니다. 실패하면 NowServiceError 객체를 반환합니다. |
[표 6. 반환]

{#NWeb-makeWebService_S__table_xct_ldx_kqb}  
<br />

    func initializeWebService() {
      NowWeb.makeWebService(instanceUrl: instanceUrl)
        .sink { completion in
          if case .failure(let error) = completion {
            debugPrint("Web Service creation failed with error: \(error.localizedDescription)")
          }
        } receiveValue: { [weak self] service in
            self?.webService = service
        }
        .store(in: &subscriptions)
      }