# Restringe una ruta con flags

> Añade @flags como @json, @xml o @upload para que una ruta solo coincida con las peticiones a las que está destinada.

Framework: total5
Product: Total.js 5 (total5@0.0.19)
Language: es
Content-SHA256: 0304b2eb2283e71d76389b014b0a96756c306a94286b0eacf582d3b62b7a8ae6
Snapshot: c0700e321579725c5cf4f5ace1ad7d2866d1b4f93c24a63c0b41b6b7998e976c
Sources: total5-installed@total5@0.0.19
Review: not-recorded

Los flags empiezan con `@` y van después de la URL. Una ruta solo coincide cuando la petición cumple todos sus flags; si no, Total.js prueba la siguiente ruta para la misma URL y responde 404 cuando ninguna coincide. Flags útiles:

- `@json` y `@xml`: el body debe ser JSON o XML
- `@xhr`: la petición debe ser AJAX (cabecera `x-requested-with`)
- `@upload`: el body debe ser `multipart/form-data`
- `@debug` y `@release`: la ruta existe solo en ese modo
- `@mobile` y `@robot`: el cliente es un navegador móvil o un rastreador

```js controllers/data.js
exports.install = function() {
	ROUTE('POST /data/ @json', json_only);
	ROUTE('POST /data/ @xml', xml_only);

	// Careful: a route with flags has a lower priority than the same URL without flags
	ROUTE('POST /mixed/ @json', json_only);
	ROUTE('POST /mixed/', anything);
};

function json_only($) {
	$.json({ handler: 'json' });
}

function xml_only($) {
	$.json({ handler: 'xml' });
}

function anything($) {
	$.json({ handler: 'anything' });
}
```

No mezcles nunca una ruta con flags y una ruta sin flags en la misma URL: la que no tiene flags se comprueba primero y se queda con todas las peticiones, así que la ruta con flags nunca se alcanza.