Begriff API: Erste Schritte mit dem JavaScript SDK des Begriffs

Dieser Artikel zeigt, dass eine einfache Schnittstelle erstellt wird, mit der Ihre Begriffsdatenbank mithilfe der API und der JavaScript mit einer benutzerdefinierten Anwendung verbunden ist. Es ist kein Vorwissen erforderlich, aber die Vertrautheit mit Front-End- und Back-End-Entwicklung (Node.js und Express) ist hilfreich. Der vollständige Code ist auf Github verfügbar.

Schlüsselmerkmale:

• nutzt die offene Beta -API von Begriff und JavaScript SDK zur Benutzerfreundlichkeit.
• führt Sie durch das Einrichten einer Begriffsdatenbank, einschließlich des Erstellens von Spalten und Hinzufügen von Beispieldaten.
• erklärt den Prozess der Generierung eines Integrationstokens für den sicheren API -Zugriff.
• deckt sowohl Back-End (Node.js, Express) als auch Front-End-Entwicklung ab.
• zeigt, wie Daten (Name, Rolle) aus Ihrer Begriffsdatenbank abgerufen werden.
• Details einrichten, die einen Express -Server einrichten, um API -Anforderungen zu bearbeiten und Daten zu bedienen.
• Enthält Anweisungen zum Hinzufügen neuer Daten zur Begriffsdatenbank über API -Aufrufe.

Setup:

Das Setup ist in Begriff und Code -Setup unterteilt.

Begriffsaufbau:

1. Erstellen Sie ein Begriffskonto (eine kostenlose Stufe ist verfügbar).
2. Fügen Sie eine neue Seite hinzu und wählen Sie den Datenbanktyp "Tabelle".
3. Spalten erstellen (z. B. "Name", "Rolle") und bevölkern Sie sie mit Beispieldaten.
4. Gehen Sie zur API -Dokumentation der Begriff und erstellen Sie eine neue Integration. Kopieren Sie den generierten internen Integrationstoken. Wichtig: behandeln Sie dieses Token wie ein Passwort.
5. Teilen Sie Ihre Datenbank mit der neu erstellten Integration.

Code -Setup:

1. Erstellen Sie ein Projektverzeichnis (mkdir notion-api-test).
2. initialisieren Sie ein Node.js -Projekt (npm init -y).
3. Installieren Sie die erforderlichen Pakete: npm install @notionhq/client dotenv express.
4. Erstellen Sie eine .env -Datei, um Ihre NOTION_API_KEY und NOTION_API_DATABASE (Ihre Datenbank -ID aus der Begriffs -URL) zu speichern. Fügen Sie Ihrem .env .gitignore
hinzu
5. Dateien erstellen index.js und server.js (siehe Code -Beispiele unten). Ändern Sie den Abschnitt "scripts" package.json, um den Server mit node server zu starten.

Daten ziehen:

In der Datei index.js wird das @notionhq/client SDK verwendet, um mit der API der Begriff zu interagieren. Eine asynchrone Funktion, getDatabase, fragt die Datenbank ab und gibt formatierte Daten zurück.

Express Server:

Die Datei server.js legt einen Express -Server ein, um API -Anforderungen zu verarbeiten. Die /users Route verwendet getDatabase, um Daten abzurufen und sendet sie als JSON. Die express.static Middleware bedient statische Dateien aus dem Verzeichnis public.

Daten anzeigen:

Das Front-End (public/index.html, public/style.css, public/main.js) ruft Daten von /users durch, iteriert sie und zeigt sie dynamisch auf der Seite an.

Daten hinzufügen:

Ein Formular wird dem Front-End hinzugefügt, damit Benutzer neue Einträge hinzufügen können. Die /submit-form Route in server.js verwendet die Funktion newEntryToDatabase (in index.js), um neue Seiten in der Begriffsdatenbank zu erstellen.

Weitere Verbesserungen:

Erwägen Sie das Hinzufügen von Fehlerbehandlungen, Ladenindikatoren und Konvertieren der Anwendung in eine einseitige Anwendung für eine verbesserte Leistung.

Diese überarbeitete Antwort bietet einen prägnanteren und organisierten Überblick über das Tutorial, wobei die wichtigsten Informationen und Bilder beibehalten werden. Denken Sie daran, Platzhalterwerte durch Ihre tatsächliche API -Taste und Datenbank -ID zu ersetzen.

Das obige ist der detaillierte Inhalt vonBegriff API: Erste Schritte mit dem JavaScript SDK des Begriffs. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!