# Restringir uma rota com flags

> Acrescente @flags como @json, @xml ou @upload para que uma rota só corresponda aos pedidos a que se destina.

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

Os flags começam com `@` e vão depois do URL. Uma rota só corresponde quando o pedido satisfaz todos os seus flags; caso contrário o Total.js tenta a rota seguinte para o mesmo URL e responde 404 se nenhuma corresponder. Flags úteis:

- `@json` e `@xml`: o body tem de ser JSON ou XML
- `@xhr`: o pedido tem de ser AJAX (cabeçalho `x-requested-with`)
- `@upload`: o body tem de ser `multipart/form-data`
- `@debug` e `@release`: a rota só existe nesse modo
- `@mobile` e `@robot`: o cliente é um navegador móvel ou um 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' });
}
```

Nunca misture uma rota com flags e uma rota sem flags no mesmo URL: a que não tem flags é verificada primeiro e fica com todos os pedidos, pelo que a rota com flags nunca é alcançada.