FCM Push Notifications - HochschuleHofStundenplanapp/Schnittstelle GitHub Wiki

Push-Benachrichtigungen für Änderungen

Für Push Benachrichtigungen registrieren

Dazu muss an
https://app.hof-university.de/soap/fcm_register_user.php
folgendes per POST-Methode geschickt werden:

  • der Token des Gerätes mit dem Key "fcm_token"

  • eine JSON mit den SplusName's der Vorlesungen für die man Benachrichtigungen erhalten möchte in folgendem Format:
    ["vorlesung_id" : "splusname"]
    z.B.:

    [  
      {"vorlesung_id":"NET§prill_1%48044 $ 2"},  
      {"vorlesung_id":"Restful§abach_2%48144 $ 2"},  
      {"vorlesung_id":"Swift3§pstöhr_2%48039 $ 2"},  
      {"vorlesung_id":"MoGr§aheda_2%48177 $ 2"},  
      {"vorlesung_id":"UED_Inf§igünther_2%48176 $ 2"},  
    ] 
    

Wichtig: Die alten registrierten SplusName's werden überschrieben! Also immer alle Vorlesung ID's schicken!

Von Benachrichtigungen abmelden

Dazu muss an folgende URL
https://app.hof-university.de/soap/fcm_register_user.php
folgendes per POST-Methode geschickt werden:

  • der Token des Gerätes mit dem Key "fcm_token"
  • ein leeres Array

Push-Benachrichtigungen empfangen

Es muss der FCM Service in die App integriert sein.

Wenn dann eine Benachrichtigung einkommt beinhaltet sie folgende Felder mit folgenden Inhalten:

'data' => array(  
  'notification_type' => 'change'  
)  
'notification' => array(  
  'title' => 'Neue Änderung',  
  'body' => 'für das Fach LABELDESFACHES',  
  'sound' => 'default'  
)  

Serverseitige Informationen

Tabellen

fcm_nutzer

Speichert die Nutzer FCM-Tokens und die Vorlesungen die sie gewählt haben

fcm_verlegungen

Speichert die ID der Verlegungen und die ID der zugehörigen Vorlesung der bereits gesendeten Benachrichtigungen