# Adicionar um middleware a uma rota

> Registe um middleware com MIDDLEWARE() e associe-o às rotas com o flag #name.

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

Um middleware é uma função que corre antes do handler da rota. Chame `next()` para continuar ou responda você ao pedido para o parar. Registe-o uma vez com `MIDDLEWARE(name, fn)` e associe-o a uma rota com `#name`.

```js definitions/middleware.js
MIDDLEWARE('apikey', function($, next) {
	if ($.headers['x-api-key'] === 'abc123')
		next();
	else
		$.invalid(401);
});
```

```js controllers/secure.js
exports.install = function() {
	ROUTE('GET /secure/ #apikey', secure);
	ROUTE('GET /open/', open);
};

function secure($) {
	$.json({ ok: true });
}

function open($) {
	$.json({ ok: true });
}
```