{

	"module": {
		"method": {
			"description": "Test de l'API",
			"permissions": [],
			"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>" }
			}
		}
	},

	"authentificationDefault": {
		"root": {
			"description": "Connexion de premier niveau : token",
			"permissions": [],
			"parameters": {
				"name":     { "description": "Nom de l'entrepot.",          "type": "varchar(3,30,alphanumeric)" },
				"password": { "description": "Mot de passe de l'entrepot.", "type": "text"                       }
			},
			"output": {}

		},

		"branch": {
			"description": "Connexion de second niveau : administrateur",
			"permissions": [],
			"parameters": {
				"name":     { "description": "Identifiant de l'administrateur.",   "type": "varchar(1,30,alphanumeric)" },
				"password": { "description": "Mot de passe de l'administrateur'.", "type": "text"                       }
			},
			"output": {}
		}
	},

	"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": ["warehouse"],
			"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" }
			}
		}

	},


	"machineDefault": {
		"create": {
			"description": "Création d'une nouvelle machine.",
			"permissions": [],
			"parameters": {
				"code": { "description": "Code RFID de la machine.", "type": "rfid"                       },
				"name": { "description": "Nom de la machine.",       "type": "varchar(1,30,alphanumeric)" }
			},
			"output": {
				"id_machine": { "description": "UID de la machine.",           "type": "id" },
				"id_cluster": { "description": "UID du groupe de la machine.", "type": "id" }
			}
		},

		"link": {
			"description": "Ajout d'une machine à un groupe.",
			"permissions": [],
			"parameters": {
				"id_machine": { "description": "UID de la machine.",           "type": "id" },
				"id_cluster": { "description": "UID du groupe de la machine.", "type": "id" }
			},
			"output": {}
		},

		"unlink": {
			"description": "Retrait d'une machine d'un groupe.",
			"permissions": [],
			"parameters": {
				"id_machine": { "description": "UID de la machine.",           "type": "id" },
				"id_cluster": { "description": "UID du groupe de la machine.", "type": "id" }
			},
			"output": {}
		},

		"search": {
			"description": "Recherche une machine par mots-clés.",
			"permissions": [],
			"parameters": {
				"keywords": { "description": "Mots-clés de recherche de machine", "type": "text" }
			},
			"output": {
				"machines": { "description": "Liste des machines correspondant à la recherche.", "type": "array<array<mixed>>" }
			}
		},

		"getAll": {
			"description": "Retourne la liste de toutes les machines.",
			"permissions": [],
			"parameters": {},
			"output": {
				"machines": { "description": "Liste de toutes les machines.", "type": "array<array<mixed>>" }
			}
		},

		"getById": {
			"description": "Retourne les données d'une machine.",
			"permissions": [],
			"parameters": {
				"id_machine": { "description": "UID de la machine.", "type": "id" }
			},
			"output": {
				"machine": { "description": "Données de la machine.", "type": "array<mixed>" }
			}
		},

		"getByCode": {
			"description": "Retourne les données d'une machine de code RFID donné.",
			"permissions": [],
			"parameters": {
				"code": { "description": "Code RFID de la machine.", "type": "rfid" }
			},
			"output": {
				"machine": { "description": "Données de la machine.", "type": "array<mixed>" }
			}
		},

		"getByName": {
			"description": "Retourne les données d'une machine de nom donné.",
			"permissions": [],
			"parameters": {
				"name": { "description": "Nom de la machine.", "type": "varchar(1,30,alphanumeric)" }
			},
			"output": {
				"machine": { "description": "Données de la machine.", "type": "array<mixed>" }
			}
		},

		"getClusters": {
			"description": "Retourne les groupes d'une machine.",
			"permissions": [],
			"parameters": {
				"id_machine": { "description": "UID de la machine.", "type": "id" }
			},
			"output": {
				"clusters": { "description": "Liste des groupes de la machine.", "type": "array<array<mixed>>" }
			}
		},

		"edit": {
			"description": "Modifie les attributs d'une machine.",
			"permissions": [],
			"parameters": {
				"id_machine": { "description": "UID de la machine.",       "type": "id"                                            },
				"code":       { "description": "Code RFID de la machine.", "type": "rfid",                       "optional": true  },
				"name":       { "description": "Nom de la machine.",       "type": "varchar(1,30,alphanumeric)", "optional": true  }
			},
			"output": {}
		},

		"delete": {
			"description": "Supprime une machine.",
			"permissions": [],
			"parameters": {
				"id_machine": { "description": "UID de la machine.", "type": "id" }
			},
			"output": {
				"status": { "description": "Status de la suppression.", "type": "boolean" }
			}
		}

	}

}