Zum Hauptinhalt springen

Schnellstart

Willkommen bei der Matesst-Dokumentation. Matesst nutzt Matesst Turbo JIT (Powered by RunMat) und GNU Octave, um Ihre .m-Skript-Algorithmen mit minimalem Aufwand in produktionsreife, hochperformante RESTful-APIs zu skalieren – ohne Code-Umschreibung.

Folgen Sie diesen 5 Schritten, um Ihre erste API in Betrieb zu nehmen.

1. Eine APP erstellen​

Melden Sie sich im Matesst Dashboard an. Navigieren Sie zu Applications und klicken Sie auf Create APP.

APP erstellen

2. Quellcode vorbereiten und hochladen​

Schreiben Sie zuerst Ihren benutzerdefinierten Algorithmus. Der Funktionsname in Ihrem Code dient als API-Einstiegspunkt. Erstellen Sie zum Beispiel eine Datei namens my_math.m:

% Datei: my_math.m
% Dies ist die Einstiegsfunktion Ihres Algorithmus.
% Der Dateiname (ohne .m) wird zum API-Endpunkt.

function [sum_val, prod_val] = my_math(a, b)
    % Ein einfacher Algorithmus zur Berechnung von Summe und Produkt
    sum_val = a + b;
    prod_val = a * b;
end

Komprimieren Sie diese Dateien direkt in ein ZIP-Format (z. B. my_math.zip). Matesst unterstützt komplexe Projektstrukturen vollständig; Sie können Ihre Skripte frei in Unterordnern innerhalb des ZIP-Archivs organisieren.

Navigieren Sie anschließend zum Bereich My Apps, wählen Sie Ihre App aus und laden Sie das ZIP-Paket hoch. Matesst analysiert automatisch die Einstiegspunkte.

ZIP hochladen

3. Verwalten & Autorisieren​

Auf der Seite mit den Anwendungsdetails können Sie den Bereitstellungsstatus überwachen. Jede Anwendung hat ihren eigenen, eindeutigen API-Key. Bewahren Sie diesen Key sicher auf, da er die Zugangsdaten für den Aufruf der API dieser spezifischen App ist.

Apps verwalten

4. Abrechnung & Gutschein einlösen​

Matesst nutzt ein Guthabensystem. Sie können Ihr Guthaben im Bereich Orders einsehen. Wenn Sie ein Kartengeheimnis haben, geben Sie die Kartennummer und das Passwort ein, um sofort Credits einzulösen.

Guthaben

5. Anrufprotokolle überwachen​

Detaillierte Ausführungshistorien finden Sie im Bereich Logs. Die Abrechnung basiert auf der Rechenzeit: 1 Credit wird pro Sekunde verbraucht (1 Credit/s). Dies hilft Ihnen bei der Kostenprüfung in Echtzeit.

Protokolle

Ihre erste Anfrage​

Sobald Ihre App aktiv ist, können Sie sie per POST-Anfrage aufrufen. Hier ist ein Beispiel für den Aufruf der oben definierten Funktion my_math. Denken Sie daran, den für Ihre App spezifischen API-Key zu verwenden:

curl -X POST https://api.matesst.com/api/v2/my_math \
  -H "Authorization: Bearer YOUR_APP_SPECIFIC_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "params": [10, 20],
    "nargout": 2
  }'

Regeln für die Ergebnisverpackung (Results Wrapping)​

Die Struktur des Feldes results hängt von nargout und der Art der zurückgegebenen Daten ab:

  • Einzelne Zahl mit nargout = 1: results gibt die Zahl direkt zurück.
  • Andernfalls: results wird immer in ein Array verpackt. Wenn eine Funktion beispielsweise ein Array [1, 2, 3] mit nargout = 1 zurückgibt, lautet die Antwort [[1, 2, 3]].

Beispiel: Einzelne Zahl (nargout = 1)​

{
  "results": 30,
  "status": "success"
}

Beispiel: Mehrere Ausgaben (nargout = 2)​

{
  "results": [30, 200],
  "status": "success"
}

Beispiel: Array-Ausgabe (nargout = 1)​

{
  "results": [[1, 2, 3]],
  "status": "success"
}

Erfahren Sie mehr in der API-Referenz.