---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Interface de chamada - Android

# Interface de chamada - Android {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 min. de leitura

A interface Chamada representa uma solicitação que está preparada para processamento.
As opções de processamento possíveis incluem:

* cancelar
* enfileirar
* execute
* mapa

Um objeto de chamada não pode ser processado duas vezes.
{#CallAndroidInterface__table_vx2_klw_5pb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| solicitação | Solicitação | Solicitação original que iniciou esta chamada. |
[Tabela 1. Propriedades]

{#CallAndroidInterface__table_vx2_klw_5pb}

## Chamada - cancel() {#ariaid-title2}

Cancela a chamada associada, se possível (melhor esforço).
{#Call-cancel__table_nsv_smt_4pb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 2. Parâmetros]

{#Call-cancel__table_nsv_smt_4pb} {#Call-cancel__table_osv_smt_4pb__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 3. Retorna]

{#Call-cancel__table_osv_smt_4pb}  
O exemplo de código a seguir mostra como chamar esta função.

    private var inFlightDataRequestCall: Call<*>? = null 
    fun cancelTransfer() = inFlightDataRequestCall?.cancel() 

## Chamada - enqueue(onSuccess: consumidor \<Response\<T\> \>, onError: consumidor\<NowDataError\> ) {#ariaid-title3}

Programa a solicitação a ser executada assim que o thread\\sistema estiver disponível para executar esta solicitação.
{#Call-enqueue_O_O__table_tnq_3nt_4pb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| onSuccess | [Consumidor](https://developer.android.com/reference/kotlin/java/util/function/Consumer.html)\<Response\<T\> \> | Retorno de chamada a ser executado se a chamada for bem-sucedida. Resposta HTTP com o corpo analisado para o tipo de dados especificado pelo parâmetro T. Nota: Consumidor é um tipo Java OOB para consumo assíncrono de um objeto. Nesse caso, a chamada usa genérico para retornar um tipo de `resposta` \<T\> em que `T` é o tipo de objeto. |
| em caso de erro | [Consumidor](https://developer.android.com/reference/kotlin/java/util/function/Consumer.html)\<NowDataError\> | Retorno de chamada a ser executado se a chamada falhar. NowDataError |
[Tabela 4. Parâmetros]

{#Call-enqueue_O_O__table_tnq_3nt_4pb} {#Call-enqueue_O_O__table_unq_3nt_4pb__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 5. Retorna]

{#Call-enqueue_O_O__table_unq_3nt_4pb}  
O exemplo de código a seguir mostra como chamar esta função.

    fun makeGraphQLRequest(query: String) { 
      val call = graphQLService.graphQLRequest(query) 
      call.enqueue( 
        { response -> handleResponse(response) }, 
        { nowDataError -> handleError(nowDataError) } 
      ) 
    } 

## Chamar - execute() {#ariaid-title4}

Invoca a solicitação imediatamente. Bloqueia até que a resposta seja processada ou esteja com erro.
{#Call-execute__table_jcm_bqt_4pb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 6. Parâmetros]

{#Call-execute__table_jcm_bqt_4pb} {#Call-execute__table_kcm_bqt_4pb__entry__2}

| Tipo | Descrição |
|-|-|
| Resposta\<T\> | Dados de resposta no formato definido no parâmetro T. |
[Tabela 7. Retorna]

{#Call-execute__table_kcm_bqt_4pb}  
O exemplo de código a seguir mostra como chamar esta função.

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