# Actionök közzététele egyetlen API-végponton

> Deklarálj ROUTE('API ...') végpontokat, hogy egy kliens sok actiont hívhasson POST {schema, data}-val egyetlen URL-en.

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

Egy API-útvonal az actionöket egyetlen URL alatt teszi közzé. A kliens mindig `POST`-ot küld `{ "schema": "name", "data": { ... } }` JSON body-val, és a Total.js a megadott néven regisztrált actionhöz irányítja. Egy URL, sok művelet: ezt a stílust beszéli a jComponent `API()` függvénye.

A név előtagja dönti el, mi történik a `data`-val:

- `+name`: az action bemenete kötelező, és ellenőrzött
- `-name`: az action nem fogad bemenetet
- `%name`: részleges bemenet (patchekhez)

```js definitions/math.js
NEWACTION('Math/add', {
	name: 'Add two numbers',
	input: '*a:Number, *b:Number',
	action: function($, model) {
		$.callback({ sum: model.a + model.b });
	}
});

NEWACTION('Math/time', {
	name: 'Server time',
	action: function($) {
		$.callback({ year: new Date().getFullYear() });
	}
});
```

```js controllers/api.js
exports.install = function() {
	ROUTE('API /api/ +math_add --> Math/add');
	ROUTE('API /api/ -math_time --> Math/time');
};
```
