API d’installation push

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 4 minutes de lecture

    • L’API d’installation push fournit des points de terminaison pour enregistrer et désinscrire les jetons qui permettent aux équipements mobiles de recevoir des notifications push d’une application.

    Une notification push est un message texte qui apparaît sur l’appareil mobile d’un utilisateur pour l’alerter de quelque chose d’important ou pour lui demander d’effectuer une action.

    Lors de la création d’applications mobiles personnalisées, pour configurer des notifications push, vous devez enregistrer l’appareil auprès du service du fabricant. Le service doit connaître l’adresse de l’appareil d’un utilisateur afin de pouvoir envoyer correctement des notifications à cet appareil à l’aide de jetons push. L’appareil doit également être capable de recevoir les notifications et d’agir en conséquence. Pour obtenir des instructions sur l’enregistrement d’un appareil et l’obtention d’un jeton push, reportez-vous à la documentation destinée aux développeurs des systèmes d’exploitation de l’appareil. Par exemple, pour les appareils Apple, reportez-vous à .https://developer.apple.com/documentation/usernotifications/registering_your_app_with_apns

    Installation push : POST /now/push/{pushApplicationName}/installation

    Ajoute ou met à jour des jetons qui permettent aux appareils de recevoir des notifications push de l’application spécifiée.

    Format d'URL

    URL versionnée : /api/now/{api_version}/push/{pushApplicationName}/installation

    URL par défaut : /api/now/push/{pushApplicationName}/installation

    Remarque :
    Les versions disponibles sont spécifiées dans l’explorateur d’API REST. Pour les API REST scriptées, des informations supplémentaires sur la version se trouvent dans le formulaire Service REST scripté.

    Paramètres de demande pris en charge

    Tableau 1. Paramètres de chemin d'accès
    Paramètre Description
    api_version Facultatif. Version du point de terminaison auquel accéder. Par exemple, v1 ou v2. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison autre que la plus récente.

    Type de données : chaîne
    pushApplicationName Nom de l’application pour laquelle enregistrer les notifications push. Ce paramètre doit être identique à la valeur de la colonne Nom de l’application associée.

    Type de données : chaîne

    Table : Application push [sys_push_application]
    Tableau 2. Paramètres de requête
    Nom Description
    Néant
    Tableau 3. Paramètres de corps de demande (XML ou JSON)
    Élément Description
    plateforme Plateforme sur laquelle enregistrer la notification push.

    Type de données : chaîne

    Table : dans le champ Nom de la table Plateforme push [sys_push_platform].
    jeton Jeton fourni par le fabricant de l’appareil, tel qu’Apple, lorsque l’application mobile s’enregistre pour recevoir des notifications push.

    Type de données : chaîne

    Stocké dans : Installation de notification push [sys_push_notif_app_install]

    En-têtes

    Les en-têtes de demande et de réponse suivants s’appliquent uniquement à cette action HTTP ou s’appliquent à cette action d’une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l’API REST, consultez En-têtes d’API REST pris en charge.

    Tableau 4. En-têtes de demandes
    En-tête Description
    Type de contenu Format des données du corps de la demande. Prend uniquement en charge application/json.
    Tableau 5. En-têtes de réponses
    En-tête Description
    Néant

    Codes d'état

    Les codes d’état suivants s’appliquent à cette action HTTP. Pour obtenir la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.

    Tableau 6. Codes d'état
    Code d'état Description
    200 Réussi. La demande a été traitée avec succès.
    400 Demande incorrecte. Un type de demande incorrecte ou mal formé a été détecté.
    401 Non autorisé. Les informations d’identification de l’utilisateur sont incorrectes ou n’ont pas été transmises.
    500 Erreur interne du serveur. Une erreur logique s’est produite sur le code côté serveur.

    Paramètres du corps de la réponse (JSON ou XML)

    Nom Description
    Néant

    Exemple de demande cURL

    curl -X POST \
  https://instance.servicenow.com/api/now/push/ServiceNowPushApp/installation \
--header "Content-Type: application/json" \
--user "username":"password" \
--data '{"platform":"Apple","token":"544836d77ac2e551bbf78204630509a7d494fc87f52e85da52e5b5d42910e2cf"}' \
    None

    Installation push : POST /now/push/{pushApplicationName}/removeInstallation

    Désactive les jetons qui permettent aux équipements mobiles de recevoir des notifications push de l’application spécifiée.

    Format d'URL

    URL versionnée : /api/now/{api_version}/push/{pushApplicationName}/removeInstallation

    URL par défaut : /api/now/push/{pushApplicationName}/removeInstallation

    Remarque :
    Les versions disponibles sont spécifiées dans l’explorateur d’API REST. Pour les API REST scriptées, des informations supplémentaires sur la version se trouvent dans le formulaire Service REST scripté.

    Paramètres de demande pris en charge

    Tableau 7. Paramètres de chemin d'accès
    Nom Description
    api_version Facultatif. Version du point de terminaison auquel accéder. Par exemple, v1 ou v2. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison autre que la plus récente.

    Type de données : chaîne
    pushApplicationName Nom de l’application pour laquelle annuler l’enregistrement des notifications push.

    Type de données : chaîne

    Table : dans le champ Nom de l’application associée dans la table Application push [sys_push_application].
    Tableau 8. Paramètres de requête
    Nom Description
    Néant
    Tableau 9. Paramètres de corps de demande (XML ou JSON)
    Élément Description
    plateforme Plateforme sur laquelle enregistrer la notification push.

    Type de données : chaîne

    Table : dans le champ Nom de la table Plateforme push [sys_push_platform].

    En-têtes

    Les en-têtes de demande et de réponse suivants s’appliquent uniquement à cette action HTTP ou s’appliquent à cette action d’une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l’API REST, consultez En-têtes d’API REST pris en charge.

    Tableau 10. En-têtes de demandes
    En-tête Description
    Type de contenu Format des données du corps de la demande. Prend uniquement en charge application/json.
    Tableau 11. En-têtes de réponses
    En-tête Description
    Néant

    Codes d'état

    Les codes d’état suivants s’appliquent à cette action HTTP. Pour obtenir la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.

    Tableau 12. Codes d'état
    Code d'état Description
    200 Réussi. La demande a été traitée avec succès.
    400 Demande incorrecte. Un type de demande incorrecte ou mal formé a été détecté.
    401 Non autorisé. Les informations d’identification de l’utilisateur sont incorrectes ou n’ont pas été transmises.
    500 Erreur interne du serveur. Une erreur logique s’est produite sur le code côté serveur.

    Paramètres du corps de la réponse (JSON ou XML)

    Nom Description
    Néant

    Exemple de demande cURL

    curl -X POST \
  https://instance.servicenow.com/api/now/push/ServiceNowPushApp/removeInstallation \
--header "Content-Type: application/json" \
--user "username":"password" \
--data '{"platform":"Apple"}' \
    None