# Más HTTP API-k hívása RESTBuilder-rel

> Küldj GET és POST kéréseket egy másik szolgáltatásnak, állíts be fejléceket és timeoutot, és olvasd a státuszt és az értelmezett választ.

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

A `RESTBuilder.GET(url)`, `.POST(url, data)`, `.PUT`, `.PATCH` és `.DELETE` kérést épít. A POST adatai JSON-ként mennek. Láncold a `.header(name, value)`, `.cookie(name, value)`, `.timeout(milliseconds)` és `.auth(user, password)` hívásokat az `.exec(function(err, response, output) {})` (vagy `await` esetén a `.promise()`) előtt.

- a `response` a body, automatikusan értelmezve, ha JSON
- az `output.status` a HTTP-státusz, az `output.headers` a válaszfejlécek
- az `err` hálózati hibáknál és HTTP-hibastátuszoknál be van állítva

A példa a saját appja két útvonalát hívja, hogy bárhol futhasson; a saját kódodban a valódi szolgáltatás címét használd. A `$.hostname(path)` felépíti ennek a szervernek a teljes URL-jét.

```js controllers/service.js
exports.install = function() {
	ROUTE('GET /api/hello/', hello);
	ROUTE('POST /api/sum/', sum);
	ROUTE('GET /call/', call);
};

function hello($) {
	$.json({ message: 'hello', agent: $.headers['x-agent'] || null });
}

function sum($) {
	$.json({ sum: $.body.a + $.body.b });
}

async function call($) {

	var greeting = await RESTBuilder.GET($.hostname('/api/hello/')).header('x-agent', 'forge').timeout(5000).promise();
	var total = await RESTBuilder.POST($.hostname('/api/sum/'), { a: 20, b: 22 }).promise();

	RESTBuilder.GET($.hostname('/api/missing/')).exec(function(err, response, output) {
		$.json({ greeting: greeting, total: total, missing: output.status });
	});
}
```