...
Cette implémentation peut se faire dans le langage de votre choix, pour réaliser cette documentation nous nous basons ici sur une implémentation réalisée en Java (avec Spring MVC).
| Sommaire |
|---|
...
getLocation
La fonction getLocations retourne la liste des lieux disponibles pour l'utilisateur connecté à l'application mobile (ex : pour la carte culture le nom d'une salle de spectacle…)
...
| Bloc de code |
|---|
* About to connect() to mon-appli-metier.univ-rouen.fr port 443 (#0) * Trying xxxxxxxxx... * Connected to mon-appli-metier.univ-rouen.fr (xxxxxxxxxx) port 443 (#0) * Initializing NSS with certpath: sql:/etc/pki/nssdb * CAfile: /etc/pki/tls/certs/ca-bundle.crt CApath: none * SSL connection using TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 * Server certificate: * subject: CN=*.univ-rouen.fr,O=Université de Rouen,L=Mont-Saint-Aignan,ST=Seine-Maritime,C=FR * start date: mai 25 00:00:00 2016 GMT * expire date: mai 30 12:00:00 2019 GMT * common name: *.univ-rouen.fr * issuer: CN=TERENA SSL CA 3,O=TERENA,L=Amsterdam,ST=Noord-Holland,C=NL > GET /nfc-ws/getLocations?eppn=badgeur@univ-rouen.fr HTTP/1.1 > User-Agent: curl/7.29.0 > Host: mon-appli-metier.univ-rouen.fr > Accept: */* > < HTTP/1.1 200 OK < Date: Wed, 24 May 2017 09:06:46 GMT < Server: Apache/2.4.6 (CentOS) OpenSSL/1.0.1e-fips < Content-Type: application/json;charset=UTF-8 < Transfer-Encoding: chunked < * Connection #0 to host mon-appli-metier.univ-rouen.fr left intact ["Inscriptions Test 1", "Inscriptions Test 2"] |
isTagable
La fonction isTagable doit permettre de déterminer si un badge est valide pour le lieu donné. Elle prend en entrée un objet « Taglog » contenant au moins eppn et location.
...
| Bloc de code |
|---|
* About to connect() to mon-appli-metier.univ-rouen.fr port 443 (#0) * Trying xxxxxxxxxxx.. * Connected to mon-appli-metier.univ-rouen.fr (xxxxxxxxxxx) port 443 (#0) * Initializing NSS with certpath: sql:/etc/pki/nssdb * CAfile: /etc/pki/tls/certs/ca-bundle.crt CApath: none * SSL connection using TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 * Server certificate: * subject: CN=*.univ-rouen.fr,O=Université de Rouen,L=Mont-Saint-Aignan,ST=Seine-Maritime,C=FR * start date: mai 25 00:00:00 2016 GMT * expire date: mai 30 12:00:00 2019 GMT * common name: *.univ-rouen.fr * issuer: CN=TERENA SSL CA 3,O=TERENA,L=Amsterdam,ST=Noord-Holland,C=NL > POST /nfc-ws/isTagable HTTP/1.1 > User-Agent: curl/7.29.0 > Host: mon-appli-metier.univ-rouen.fr > Accept: */* > Content-Type: application/json > Content-Length: 65 > * upload completely sent off: 65 out of 65 bytes < HTTP/1.1 500 Erreur Interne de Servlet < Date: Tue, 23 May 2017 10:17:57 GMT < Server: Apache/2.4.6 (CentOS) OpenSSL/1.0.1e-fips < Content-Type: text/plain;charset=ISO-8859-1 < Content-Length: 15 < Connection: close < * Closing connection 0 Carte invalide |
validateTag
Cette fonction valide le badgeage et déclenche un traitement metier. Elle doit prendre en entrée un objet « Taglog » contenant au moins eppn et location. Elle retourne un statut http 200 si le traitement s'est bien déroulé ou une erreur http 500 dans le cas contraire.
...
| Bloc de code |
|---|
* About to connect() to mon-appli-metier.univ-rouen.fr port 443 (#0) * Trying xxxxxxxxxx... * Connected to mon-appli-metier.univ-rouen.fr (xxxxxxxxxxx) port 443 (#0) * Initializing NSS with certpath: sql:/etc/pki/nssdb * CAfile: /etc/pki/tls/certs/ca-bundle.crt CApath: none * SSL connection using TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 * Server certificate: * subject: CN=*.univ-rouen.fr,O=Université de Rouen,L=Mont-Saint-Aignan,ST=Seine-Maritime,C=FR * start date: mai 25 00:00:00 2016 GMT * expire date: mai 30 12:00:00 2019 GMT * common name: *.univ-rouen.fr * issuer: CN=TERENA SSL CA 3,O=TERENA,L=Amsterdam,ST=Noord-Holland,C=NL > POST /nfc-ws/validateTag HTTP/1.1 > User-Agent: curl/7.29.0 > Host: mon-appli-metier.univ-rouen.fr > Accept: */* > Content-Type: application/json > Content-Length: 65 > * upload completely sent off: 65 out of 65 bytes < HTTP/1.1 200 OK < Date: Tue, 23 May 2017 10:21:02 GMT < Server: Apache/2.4.6 (CentOS) OpenSSL/1.0.1e-fips < Content-Type: text/plain;charset=ISO-8859-1 < Content-Length: 2 < * Connection #0 to host mon-appli-metier.univ-rouen.fr left intact OK |
getDisplay
Cette fonction "POST" prend en entrée un objet TagLog et retourne une page html. Si cette fonction est déclarée dans le AppliExtRestWs, elle sera