API d’installation push

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 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’avertir de quelque chose d’important ou pour lui demander d’effectuer une action.

    Lors de la création d’applications mobiles personnalisées, afin de 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, consultez la documentation du développeur du système 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 basées sur un script, des informations de version supplémentaires sont disponibles sur 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 différente de la dernière.

    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
    Aucun
    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’inscrit pour recevoir des notifications push.

    Type de données : chaîne

    Stockée 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 à cette action HTTP uniquement 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
    Content-Type Format de 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
    Aucun

    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é correctement traitée.
    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
    Aucun

    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 basées sur un script, des informations de version supplémentaires sont disponibles sur 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 différente de la dernière.

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

    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
    Aucun
    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 à cette action HTTP uniquement 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
    Content-Type Format de 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
    Aucun

    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é correctement traitée.
    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
    Aucun

    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