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

Total.js 5 · total5@0.0.19 routingapiactions Total.js 5-tel lefuttatva

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)

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

controllers/api.js

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