---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Interagieren Sie mit der öffentlichen REST-API auf einem ServiceNowInstanz

# Interagieren Sie mit der öffentlichen REST-API auf einem ServiceNowInstanz {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 Minute Lesedauer

Die Mobile SDKBietet Funktionen, die aktiviert werden AndroidAnwendungen zum Aufrufen der öffentlichen REST-API auf einem ServiceNowInstanz.
Mit [Now APIService](https://servicenow-prod.fluidtopics.net/kNh4vvF9F3klZdj~9MN~RQ#NowAPIServiceAndroidInterface "Die Now APIService Die Schnittstelle bietet die Möglichkeit, Anforderungen für einen angegebenen auszuführen ServiceNowREST-API.")API, mit der Sie mit einer beliebigen Basis interagieren können ServiceNowÖffentlich [REST-APIs](https://servicenow-prod.fluidtopics.net/yfzJY_q_SSBWSvv8_qNjRw "Verwenden Sie REST-Schnittstellen, um auf Daten in Ihrer Instanz zuzugreifen."), Oder erstellen Sie anwenderdefinierte REST-APIs in der Instanz, und rufen Sie diese von Ihrem auf AndroidAnwendung.

Bevor Sie einen Anruf an tätigen ServiceNowREST-API, Sie müssen aufrufen [MakeNowAPIService()](https://servicenow-prod.fluidtopics.net/N5kbngoz2DAPUrUY1LigHA#NDataSDK-makeNowAPIService_S_O_O "Erstellt und initialisiert eine Instanz des NowAPIService-Service. Mit diesem Service können Sie auf die öffentlichen REST-APIs zugreifen, die von Ihrem bereitgestellt werden ServiceNowInstanz.")Methode zum Erstellen einer Instanz des Service. Die Serviceinstanz wird im Rückruf zurückgegeben, wenn dies erfolgreich ist, andernfalls wird ein Fehler ausgelöst.  
Im Folgenden wird gezeigt, wie ein NowAPIService-Objekt initialisiert wird:

    /**
     * Helper class used to handle different Now service instances. It has an application scope or is Singleton
     */
    @Singleton
    class SdkManager @Inject constructor() {

        private var nowApiService: NowAPIService? = null

        /**
         * Create the NowAPIService once in the lifetime of the application inside the Application class or another manager class
         * that will be injected into other classes via dagger/hilt.
         * NowAPIService should be created after initializing the NowSDK
         */
        suspend fun getNowApiService(): NowAPIService? {
            if (nowApiService != null) return nowApiService

            return NowDataSDK.makeAPIService(URL("https://instance-name.service-now.com")).getOrThrow()
                .also { this.nowApiService = it }
        }

    }

Sobald das NowAPIService-Objekt initialisiert wurde, verwenden Sie den NowAPIService [Daten()](https://servicenow-prod.fluidtopics.net/kNh4vvF9F3klZdj~9MN~RQ#NAPIServ-data_S_S_S_S "Ruft die angegebene REST-API auf dem angegebenen auf ServiceNowInstanz.")Methode zum Angeben des aufzurufenden REST-Endpunkts und aller zugehörigen Parameter:

     suspend fun makeNowApiCall() {
      val apiService = sdkManager.getNowApiService()

      val apiPath = "api/now/table/sn_customerservice_case"
      val endpoint = NowAPIService.Endpoint(HttpMethod.GET, apiPath, true)
      val fieldNames = "sys_id,number,short_description,number,priority,state," +
        "opened_at,account.name,account.number,contact.name,contact.email," +
        "contact_type,assignment_group.name,assigned_to.name"

      val queryParamsMap = mapOf("sysparm_fields" to fieldNames, "sysparm_limit" to "10")

      val queryParams = QueryParams.Builder().addAll(queryParamsMap).build()

      val response = runCatching {
        apiService?.data(endpoint = endpoint, queryParams = queryParams)?.execute()
      }

      if (response.isSuccess) {
        val resultString = response.getOrNull()?.body?.let { String(it) }
      } else {
        // Handle error
      }
    }


