http

Mit dieser Funktion können Sie eine API-Anfrage senden, um auf Daten außerhalb Ihrer aktuellen Datenbank zuzugreifen. Sie können einige externe Dienste integrieren oder Daten zwischen 2 Datenbanken austauschen.

Diese Funktion kann bis zu 4 Parameter aufnehmen:

• Methode Ein String, der die HTTP-Methode für den API-Aufruf festlegt. Das ist normalerweise "GET", "POST", "PUT" oder"DELETE"

• URL Ein String mit der URL zum externen Dienst

• Header Ein optionales JSON-Objekt mit Metadaten zum API-Aufruf wie einen API-Schlüssel oder den Content-Type.

• Body Ein optionales JSON-Objekt üblicherweise mit den Daten, die mit anderen externen Diensten geteilt werden.

API zu verwenden, erfordert eventuelle zusätzliche Kenntnisse. Erfahren Sie mehr über API >

Syntax

http(string, string)

http(string, string, JSON)

http(string, string, JSON, JSON)

Mit Dateien

http(string, string, JSON, [file])

http(string, string, JSON, JSON, [file])

Rückgabewert

JSON

Beispiel

http(methode, url)ruft REST-Services ohne Header oder Body ab.

http(methode, url, header) ruft REST-Services auf – die Methode und die URL sind Strings; der (optionale) Header ist ein JSON-Objekt.

http(method, url, header, body) ruft REST-Services auf – die Methode und die URL sind Strings (Header und Body sind optionale Objekte).

let url := "https://api.ninoxdb.de/v1/teams/" + teamId() + "/databases/" + databaseId() + "/tables/";
let myAPIKey := "Bearer abcd1234-0000-xxxx-zzzz-1a1aa1aaa1a111";
let response := http("GET", url, {
		Authorization: myAPIKey
	}, null);
response

Ergebnis: Sie enthalten ein JSON-Objekt, das entweder alle Tabellen der Datenbank enthält, wenn der API-Aufruf erfolgreich ist, oder ein JSON-Objekt mit einer Fehlermeldung, wenn nicht.

do as server
	let url := "https://api.ninoxdb.de/v1/teams/" + teamId() + "/databases/" + databaseId() + "/query";
	let APIKey := "Bearer abcd1234-0000-xxxx-zzzz-1a1aa1aaa1a111";
	let response := http("POST", url, {
			Authorization: APIKey,
			'content-type': "application/json"
		}, {
			query: "select Kunden where Status = 4"
		});
	response
end

Ergebnis: Sie erhalten ein JSON-Objekt mit allen Datensätzen der Kunden-Tabelle, wo der Status = 4 ist, wenn der API-Aufruf erfolgreich ist, oder ein JSON-Objekt mit einer Fehlermeldung, wenn nicht.

Mit Dateien

http(methode, url, header, dateien) ruft REST-Services auf und sendet eine Liste von Dateien mit – die Methode und die URL sind Strings; der (optionale) Header ist ein JSON-Objekt.

http(methode, url, header, body, dateien) ruft REST-Services auf und sendet eine Liste von Dateien mit – die Methode und die URL sind Strings (Header und Body sind optionale Objekte).

Siehe auch

Mehr zur http()-Funktion unter API (in unserer englischen Dokumentation)