# Извикване на API маршрути на Total.js с API()

> Използвайте API(url, name, data, callback), за да извиквате действията на крайна точка ROUTE('API ...'), включително грешките при валидиране.

Framework: jcomponent20
Product: jComponent 20 (jcomponent@20)
Language: bg
Content-SHA256: ff3baba0aa8706a277cd5311a5e5441e80baca7b15d47904a5aeca6a71f35d5b
Snapshot: c0700e321579725c5cf4f5ace1ad7d2866d1b4f93c24a63c0b41b6b7998e976c
Sources: jcomponent20@3fedd009a277f50fddc608b97afbec553b67c51b
Review: not-recorded

`API(url, name, data, callback)` е клиентската страна на крайните точки `ROUTE('API ...')` на Total.js. Изпраща `POST url` с body `{ schema: name, data: data }` и извиква callback с отговора. Когато сървърът отговори с грешка (например при валидиране), callback получава масив от грешки: използвайте helper `ERROR(response, success, error)`, за да обработите и двата случая на едно място.

Поставете адреса на крайната точка в `ENV()` веднъж и го използвайте повторно.

```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 });
	}
});
```

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

```html public/index.html
<!DOCTYPE html>
<html>
<head>
	<meta charset="utf-8" />
	<title>jComponent</title>
	<link rel="stylesheet" href="//cdn.componentator.com/spa.min@20.css" />
	<script src="//cdn.componentator.com/spa.min@20.js"></script>
</head>
<body>
	<p class="sum"></p>
	<p class="error"></p>

	<script>

		ENV('api', '/api/');

		API('[api]', 'math_add', { a: 20, b: 22 }, function(response) {
			SET('sum', response.sum);
		});

		API('/api/', 'math_add', { a: 'x' }, function(response) {
			ERROR(response, function(value) {
				SET('failed', 'unexpected success');
			}, function(errors) {
				SET('failed', errors[0].name);
			});
		});

	</script>

</body>
</html>
```
