# Appeler les routes API de Total.js avec API()
> Utilisez API(url, name, data, callback) pour appeler les actions d'un endpoint ROUTE('API ...'), erreurs de validation comprises.
Framework: jcomponent20
Product: jComponent 20 (jcomponent@20)
Language: fr
Content-SHA256: 53703b5dc8ffba8ee1b8049ea4572b9cf2daa0ec2165bbc2c4f428ff292cc652
Snapshot: c0700e321579725c5cf4f5ace1ad7d2866d1b4f93c24a63c0b41b6b7998e976c
Sources: jcomponent20@3fedd009a277f50fddc608b97afbec553b67c51b
Review: not-recorded
`API(url, name, data, callback)` est le côté client des endpoints `ROUTE('API ...')` de Total.js. Elle envoie `POST url` avec le body `{ schema: name, data: data }` et appelle le callback avec la réponse. Quand le serveur répond par une erreur (par exemple de validation), le callback reçoit un tableau d'erreurs : utilisez le helper `ERROR(response, success, error)` pour traiter les deux cas au même endroit.
Placez l'adresse de l'endpoint dans `ENV()` une fois pour toutes et réutilisez-la.
```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
jComponent
```