Deine erste Qino-App

Wir bringen zuerst eine kleine Sache zum Laufen: eine URL, die JSON zurückgibt. Du brauchst nur Deno und eine Datei. Ein Konto, ein CMS-Setup oder ein eigener Datenbankserver sind nicht nötig.

Diese Anleitung verwendet Deno. Für Bun und Node gibt es die Runtime-Anleitung auf Englisch.

1. Qino installieren

In einem neuen Ordner:

mkdir hello-qino
cd hello-qino
deno add jsr:@qino/qino@^0.7

2. Eine Datei anlegen

Lege server.ts an:

import { Access, App, sys } from "@qino/qino";

const app = new App();

app.apiTree = {
  hello: {
    get: {
      description: "Say hello",
      access: Access.PUBLIC,
      execute: () => ({ message: "Hello from Qino" }),
    },
  },
};

await app.init();
sys.serve({ port: 8080 }, app.fetch);

Du kannst das ganze Beispiel kopieren. hello bestimmt die URL, get beantwortet eine Browser-Anfrage und Access.PUBLIC lässt dich das Ergebnis ohne Anmeldung ansehen.

3. Server starten

deno run --allow-all server.ts

Lass das Terminal offen. Öffne im Browser localhost:8080/api/hello. Du solltest Folgendes sehen:

json

{"message":"Hello from Qino"}

Das ist dein erster Qino-Endpunkt. Für dieses lokale Beispiel gibt --allow-all dem Server die nötigen Berechtigungen; beim Veröffentlichen kannst du sie einschränken.

Was ist passiert?

new App() erstellt die App. SQLite funktioniert ohne eigenen Datenbankserver.
app.apiTree beschreibt, welche URL was macht.
app.init() bereitet die App vor; sys.serve() startet den Server.

Womit möchtest du weitermachen?

Eine weitere API-Aktion für eine API.
Eine bearbeitbare Website mit Qinos CMS.
Ein eigenes Modul, wenn eine Funktion für sich stehen soll.

Das Beispiel folgt dem Qino README. Die weiterführenden Anleitungen sind derzeit auf Englisch.