SMMP/config/modules.json

{


	"machineDefault" :[
		"create",

		"link",
		"unlink",

		"search",

		"getAll",
		"getById",
		"getByCode",
		"getByName",

		"getClusters",

		"edit",

		"delete"
	],


	"module": {
		"method": {
			"description": "Test de l'API",
			"permissions": [],
			"parameters": {}
		},

		"phpunitParams": {
			"description": "Méthode utile à phpunit pour le test des paramètres.",
			"permissions": [],
			"parameters": {
				"p1": { "description": "Texte", "type": "text" },
				"p2": { "description": "Entier positif", "type": "id" }
			},
			"output": {
				"receivedArguments": { "description": "Liste des arguments reçus par la méthode", "type": "array<mixed>" }
			}
		},

		"phpunitOptionalParams": {
			"description": "Méthode utile à phpunit pour le test des paramètres optionnels.",
			"permissions": [],
			"parameters": {
				"p1": { "description": "Texte", "type": "text"                                      },
				"p2": { "description": "Texte", "type": "text", "optional": false                   },
				"p3": { "description": "Entier positif (optionnel)", "type": "id", "optional": true }
			}
		},

		"phpunitPermissions": {
			"description": "Méthode utile à phpunit pour le test des permissions.",
			"permissions": ["a", "b"],
			"parameters": {}
		},


		"markdown": {
			"description": "Retourne une description en markdown des différents modules de l'API",
			"permissions": [],
			"options": { "download": true },
			"parameters": {}
		},


		"apiBlueprint": {
			"description": "Retourne une documentation de l'API au format API Blueprint.",
			"permissions": [],
			"options": { "download": true },
			"parameters": {}
		}
	},


	"upload": {

		"call_log": {
			"description": "Upload d'un journal d'appel au format .xml. Retour des données de call_log/unserialize",
			"permissions": ["admin"],
			"parameters": {
				"file": { "description": "Fichier du journal d'appel.", "type": "FILE" }
			},
			"output": {
				"tmp_id":    { "description": "Identifiant temporaire du journal d'appel", "type": "varchar(40,40)" },
				"directory": { "description": "Annuaire des contacts trouvés", "type": "array<array<mixed>>" },
				"call":      { "description": "Liste des identifiants des contacts triés par nombre d'appels", "type": "array<id>" },
				"sms":       { "description": "Liste des identifiants des contacts triés par nombre de sms",   "type": "array<id>" }
			}
		}
	},


	"download": {

		"multiple": {
			"description": "Download des données relatives aux sujets donnés.",
			"permissions": ["admin"],
			"options": { "download": true },
			"parameters": {
				"subjects": { "description": "Identifiants des sujets d'enquêtes à intégrer.",     "type": "array<id>", "optional": true },
				"phone":    { "description": "Si vaut TRUE, renvoie les sujets cellulaires.",      "type": "boolean",   "optional": true },
				"facebook": { "description": "Si vaut TRUE, renvoie les sujet facebook.",          "type": "boolean",   "optional": true },
				"survey":   { "description": "Si vaut TRUE, renvoie les sujets ResTIC.",           "type": "boolean",   "optional": true },
				"all":      { "description": "Si vaut TRUE, renvoie tous les sujets enregistrés.", "type": "boolean",   "optional": true }
			}
		}
	},










	"userDefault": {

		"create": {
			"description": "Création d'un nouvel utilisateur.",
			"permissions": [],
			"parameters": {
				"code":      { "description": "Code RFID de l'utilisateur.",    "type": "rfid"                       },
				"username":  { "description": "Identifiant de l'utilisateur.",  "type": "varchar(1,30,alphanumeric)" },
				"firstname": { "description": "Prénom de l'utilisateur.",       "type": "varchar(3,30,letters)"      },
				"lastname":  { "description": "Nom de l'utilisateur.",          "type": "varchar(3,30,letters)"      },
				"mail":      { "description": "Adresse mail de l'utilisateur.", "type": "mail"                       },
				"password":  { "description": "Mot de passe de l'utilisateur.", "type": "text"                       },
				"status":    { "description": "Status de l'utilisateur.",       "type": "status"                     }
			},
			"output": {
				"id_user":  { "description": "UID de l'utilisateur créé.",      "type": "id" },
				"id_group": { "description": "UID du groupe de l'utilisateur.", "type": "id" }
			}
		},

		"link": {
			"description": "Ajout d'un utilisateur à un groupe.",
			"permissions": [],
			"parameters": {
				"id_cluster": { "description": "UID du groupe auquel rattacher.",   "type": "id" },
				"id_user":    { "description": "UID de l'utilisateur à rattacher.", "type": "id" }
			},
			"output": {}
		},


		"unlink": {
			"description": "Retrait d'un utilisateur d'un groupe",
			"permissions": [],
			"parameters": {
				"id_cluster": { "description": "UID du groupe auquel détacher.",   "type": "id" },
				"id_user":    { "description": "UID de l'utilisateur à détacher.", "type": "id" }
			},
			"output": {

			}
		},

		"search": {
			"description": "Recherche d'un utilisateur par mots-clés.",
			"permissions": [],
			"parameters": {
				"keywords": { "description": "Mots-clés de la recherche.", "type": "text" }
			},
			"output": {
				"users": { "description": "Liste des utilisateurs correspondants aux mots-clés.", "type": "array<mixed>" }
			}
		},

		"getAll": {
			"description": "Liste de tous les utilisateurs",
			"permissions": [],
			"parameters": {},
			"output": {
				"users": { "description": "Liste de tous les utilisateurs.", "type": "array<array<mixed>>" }
			}
		},

		"getById": {
			"description": "Retourne un utilisateur spécifique.",
			"permissions": [],
			"parameters": {
				"id_user": { "description": "UID de l'utilisateur.", "type": "id" }
			},
			"output": {
				"user": { "description": "Données de l'utilisateur.", "type": "array<mixed>" }
			}
		},

		"getByCode": {
			"description": "Retourne un utilisateur de Code RFID donné.",
			"permissions": [],
			"parameters": {
				"code": { "description": "Code RFID de l'utilisateur.", "type": "rfid" }
			},
			"output": {
				"user": { "description": "Données de l'utilisateur.", "type": "array<mixed>" }
			}
		},

		"getByUsername": {
			"description": "Retourne un utilisateur d'identifiant donné.",
			"permissions": [],
			"parameters": {
				"username": { "description": "Identifiant de l'utilisateur.", "type": "varchar(1,30,alphanumeric)" }
			},
			"output": {
				"user": { "description": "Données de l'utilisateur.", "type": "array<mixed>" }
			}
		},

		"getClusters": {
			"description": "Retourne les groupes d'un utilisateur.",
			"permissions": [],
			"parameters": {
				"id_user": { "description": "UID de l'utilisateur.", "type": "id" }
			},
			"output": {
				"clusters": { "description": "Liste des groupes de l'utilisateur.", "type": "array<array<mixed>>" }
			}
		},

		"edit": {
			"description": "Modifie les attributs d'un utilisateur.",
			"permissions": [],
			"parameters": {
				"id_user":   { "description": "UID de l'utilisateur.",          "type": "id"                                           },
				"code":      { "description": "Code RFID de l'utilisateur.",    "type": "rfid",                       "optional": true },
				"username":  { "description": "Identifiant de l'utilisateur.",  "type": "varchar(1,30,alphanumeric)", "optional": true },
				"firstname": { "description": "Prénom de l'utilisateur.",       "type": "varchar(3,30,letters)",      "optional": true },
				"lastname":  { "description": "Nom de l'utilisateur.",          "type": "varchar(3,30,letters)",      "optional": true },
				"mail":      { "description": "Adresse mail de l'utilisateur.", "type": "mail",                       "optional": true },
				"password":  { "description": "Mot de passe de l'utilisateur.", "type": "text",                       "optional": true },
				"status":    { "description": "Status de l'utilisateur.",       "type": "status",                     "optional": true }

			},
			"output": {
				"status": { "description": "Status de la modification.", "type": "boolean" }
			}
		},

		"delete": {
			"description": "Suppression d'un utilisateur.",
			"permissions": [],
			"parameters": {
				"id_user": { "description": "UID de l'utilisateur.", "type": "id" }
			},
			"output": {
				"status": { "description": "Status de la suppression.", "type": "boolean" }
			}
		}

	}


}