API d’installation push

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 4 minutes de lecture

    • L’API d’installation push fournit des points de terminaison pour enregistrer et annuler l’inscription des 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’équipement mobile d’un utilisateur pour l’alerter d’un élément 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’y donner suite. Pour obtenir des instructions sur l’enregistrement d’un appareil et l’obtention d’un jeton push, consultez la documentation du développeur 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 les 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

    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. 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) 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 dans la table Application push [sys_push_application].

    Type de données : chaîne
    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. Ce paramètre doit être la valeur Nom de la table Plateforme push [sys_push_platform].

    Type de données : chaîne
    jeton Jeton fourni par le fabricant de l’appareil, tel qu’Apple, lorsque l’application mobile s’inscrit pour recevoir des notifications push. Le point de terminaison écrit la valeur du jeton dans la table Installation de notification push [sys_push_notif_app_install].

    Type de données : chaîne

    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 une 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 une 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 sur le code côté serveur s’est produite.

    Paramètres de corps de 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

    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. 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) Nom de l’application dont l’enregistrement des notifications push doit être annulé. Ce paramètre doit être identique à la valeur de la colonne Nom de l’application associée dans la table Application push [sys_push_application].

    Type de données : chaîne
    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. Ce paramètre doit être la valeur Nom de la table Plateforme push [sys_push_platform].

    Type de données : chaîne

    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 une 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 une 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 sur le code côté serveur s’est produite.

    Paramètres de corps de 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