Historique de la page

...

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).

tagIdCheck

La fonction tagIdChek à pour but de retourver l'identifiant (login ou eppn) d'un individu en fonction de son numéro de carte (csn ou identifiant desfire).

Pour ce faire il faut implémenter une fonction ou un webservice qui accepte en entrée csn et/ou desfire et qui retourne un objet « TagLog » contenant à minima :

@JsonIgnoreProperties(ignoreUnknown=true)
public class TagLog {
	String csn;
	String eppn;
 	String lastname;
 	String firstname;
 	String location;
	String eppnInit;
}

getLocations

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…)

La fonction prend en entrée l'identifiant de l'utilisateur (eppn) et retourne une liste de String des salles gérées par l'utilisateur.

@RequestMapping(value = "/getLocations", method = RequestMethod.GET, produces = "application/json;charset=UTF-8")
@ResponseBody
public List<String> getLocations(@RequestParam String eppn) {
	List<String> listSalles = new ArrayList<String>();
	listSalles.add("Salle de test");
	return listSalles;
}

isTagable

La fonction isTagable doit permettre de déterminer si un badge est valide pour le lieu donné. Elle prend doit prendre en entrée un objet « Taglog » contenant au moins eppn et location.

...

HttpStatus.INTERNAL_SERVER_ERROR (500), accompagné d'un message dans le corps de la réponse si l'individu n'est pas autorisé

ex :

@RequestMapping(value = "/isTagable", method = RequestMethod.POST)
@ResponseBody
public ResponseEntity<String> eppnCheck(@RequestBody EsupNfcTagLog esupNfcTagLog) {
	if((Math.random() <= 0.5) {
		return new ResponseEntity<String>("OK", responseHeaders, HttpStatus.OK);

return new
	} else {
		return new ResponseEntity<String>("Carte invalide", new responseHeadersHttpHeaders(), HttpStatus.INTERNAL_SERVER_ERROR);
	}
}

validateTag

Cette fonction valide le badgeages et déclenche un traitement metier. lle prend doit prendre en entrée un objet « Taglog » contenant au moins eppn et location. Elle retourne un statut http 200 si le traitement c'est bien déroulé ou une erreur http 500 dans le cas contraire.

@RequestMapping(value = "/validateTag", method = RequestMethod.POST)
@ResponseBody
public ResponseEntity<String> eppnValidate(@RequestBody EsupNfcTagLog esupNfcTagLog, HttpServletRequest httpServletRequest) {
	if((Math.random() <= 0.5) {
		return new ResponseEntity<String>("OK", new HttpHeaders(), HttpStatus.OK);
	} else {
		return new ResponseEntity<String>("KO", new HttpHeaders(), HttpStatus.INTERNAL_SERVER_ERROR);
	}
}