---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Référence de l’API Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Interface d'appel : Android

# Interface d'appel : Android {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute de lecture

L'interface d'appel représente une demande préparée pour traitement.
Les options de traitement possibles sont les suivantes :

* annuler
* Enqueue
* execute
* carte

Un objet d'appel ne peut pas être traité deux fois.
{#CallAndroidInterface__table_vx2_klw_5pb__entry__3}

| Nom | Type | Description |
|-|-|-|
| request | Demande | Demande d'origine à l'origine de cet appel. |
[Tableau 1. Propriétés]

{#CallAndroidInterface__table_vx2_klw_5pb}

## Appeler : cancel() {#ariaid-title2}

Annule l'appel associé, si possible (dans la mesure du possible.)
{#Call-cancel__table_nsv_smt_4pb__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 2. Paramètres]

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

| Type | Description |
|-|-|
| Aucun |   |
[Tableau 3. Renvoie]

{#Call-cancel__table_osv_smt_4pb}  
L'exemple de code suivant montre comment appeler cette fonction.

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

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

Planifie l'exécution de la demande dès que le système\\thread est disponible pour exécuter cette demande.
{#Call-enqueue_O_O__table_tnq_3nt_4pb__entry__3}

| Nom | Type | Description |
|-|-|-|
| onSuccess (en anglais) | [Consommateur](https://developer.android.com/reference/kotlin/java/util/function/Consumer.html)\<Réponse\<T\>\> | Rappel à exécuter en cas de réussite de l'appel. Réponse HTTP dont le corps est analysé selon le type de données spécifié par le T paramètre. Remarque : Consommateur est un type Java OOB pour la consommation asynchrone d'un objet. Dans ce cas, l'appel utilise generic pour renvoyer un type `Response<T>` où `T` est le type d'objet. |
| onError (en anglais seulement) | [Erreur](https://developer.android.com/reference/kotlin/java/util/function/Consumer.html)\<NowData\> | Rappel à exécuter en cas d'échec de l'appel. NowDataError (en anglais seulement) |
[Tableau 4. Paramètres]

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

| Type | Description |
|-|-|
| Aucun |   |
[Tableau 5. Renvoie]

{#Call-enqueue_O_O__table_unq_3nt_4pb}  
L'exemple de code suivant montre comment appeler cette fonction.

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

## Appeler : execute() {#ariaid-title4}

Invoque la demande immédiatement. Bloque jusqu'à ce que la réponse soit traitée ou qu'elle soit en erreur.
{#Call-execute__table_jcm_bqt_4pb__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 6. Paramètres]

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

| Type | Description |
|-|-|
| Réponse \<T\> | Données de réponse au format défini dans le T paramètre. |
[Tableau 7. Renvoie]

{#Call-execute__table_kcm_bqt_4pb}  
L'exemple de code suivant montre comment appeler cette fonction.

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