Frontend API Client mit JWT-Skill
Wann dieser Skill verwendet wird
Verwenden Sie diesen konzeptionellen Skill, wenn Sie einen robusten API-Client in Next.js implementieren müssen, der JWT-Tokens für die Authentifizierung korrekt verwaltet. Dieser Skill eignet sich für:
- Erstellung einer zentralen API-Kommunikationsschicht in Next.js-Anwendungen
- Verwaltung der JWT-basierten Authentifizierung über mehrere API-Endpunkte hinweg
- Behandlung von Token-Ablauf und -Erneuerungsszenarien
- Standardisierung der Analyse und Behandlung von Fehlerantworten
- Implementierung sicherer API-Kommunikationsmuster
Dieser Skill sollte NICHT verwendet werden für:
- Anwendungen ohne JWT-basierte Authentifizierung
- Statische Websites ohne API-Kommunikationsbedarf
- Anwendungen mit alternativen Authentifizierungsmethoden (API-Schlüssel, OAuth 2.0-Client-Anmeldedaten usw.)
- Einfache Anwendungen mit minimaler API-Interaktion
Voraussetzungen
- Next.js-Anwendung (entweder App Router oder Pages Router)
- Verständnis der JWT-Konzepte (JSON Web Token)
- Kenntnisse über HTTP-Header und Autorisierungsmechanismen
- Grundlegendes Verständnis asynchroner JavaScript-Operationen
- Bewusstsein für clientseitige vs. serverseitige Ausführungskontexte
Konzeptioneller Implementierungsrahmen
Fähigkeit zur Autorisierungs-Header-Anhängung
- Automatisches Anhängen von JWT-Tokens an API-Anfragen als Autorisierungs-Header
- Bestimmen, wann Tokens basierend auf Anfragetyp und Endpunkt eingefügt werden sollen
- Behandlung der Token-Anhängung sowohl für clientseitige als auch für serverseitige Anfragen
- Angemessene Verwaltung der Token-Einbindung bei Cross-Origin-Anfragen
- Sicherstellung der korrekten Header-Formatierung ("Bearer ")
Fähigkeit zur Behandlung des Token-Ablaufs
- Erkennung des JWT-Token-Ablaufs vor dem Senden von API-Anfragen
- Implementierung automatischer Token-Erneuerungsmechanismen
- Graceful Handling von Token-Erneuerungsfehlern
- Aufrechterhaltung der Sitzungskontinuität während der Token-Erneuerung
- Koordination der Token-Erneuerung über mehrere gleichzeitige Anfragen hinweg
- Sicheres Speichern aktualisierter Tokens nach der Erneuerung
Fähigkeit zur Analyse von Fehlerantworten
- Analyse strukturierter Fehlerantworten von API-Endpunkten
- Identifizierung authentifizierungsbezogener Fehler (401, 403) für spezielle Behandlung
- Extrahieren aussagekräftiger Fehlermeldungen für Benutzerfeedback
- Konsistente Behandlung verschiedener Fehlerantwortformate
- Unterscheidung zwischen Client-Fehlern, Server-Fehlern und Netzwerkproblemen
- Bereitstellung angemessenen Benutzerfeedbacks basierend auf Fehlertypen
Fähigkeit zur Zentralisierung von API-Aufrufen
- Erstellung einer einheitlichen Schnittstelle für alle API-Kommunikationen
- Standardisierung der Anfrage- und Antwortbehandlung in der gesamten Anwendung
- Implementierung konsistenter Fehlerbehandlung und -protokollierung
- Verwaltung von Anfrage-/Antwort-Interceptoren für querschnittliche Belange
- Bereitstellung typsicherer API-Aufrufmuster (bei Verwendung von TypeScript)
- Ermöglichung von Anfrage-Caching und -Deduplizierung, wo angemessen
Erwartete Eingabe/Ausgabe
Eingabeanforderungen:
-
JWT-Token-Verwaltung:
- Gültiges JWT-Token für die Autorisierung
- Konfiguration des Token-Erneuerungsendpunkts
- Token-Speichermechanismus (localStorage, Cookies usw.)
- Token-Ablaufzeit und Erneuerungszeitpunkt
-
API-Konfiguration:
- Basis-API-URL für Anfragen
- Timeout-Einstellungen für Anfragen
- Benutzerdefinierte Header und Anfrageoptionen
- Endpunktspezifische Konfigurationen
-
Anfrageparameter:
- HTTP-Methode (GET, POST, PUT, DELETE usw.)
- Anfrage-URL oder Endpunktbezeichner
- Anforderungstext für POST/PUT-Operationen
- Abfrageparameter und Pfadvariablen
Ausgabeformate:
-
Erfolgreiche API-Antwort:
- HTTP-Statuscodes 200-299
- Analysierte Antwortdaten, die dem erwarteten Format entsprechen
- Aktualisierte Token-Informationen, falls zutreffend
- Konsistente Antwortstruktur über alle Endpunkte hinweg
-
Authentifizierungsfehlerantwort:
- HTTP 401 Nicht autorisiert für abgelaufene/ungültige Tokens
- Automatischer Token-Erneuerungsversuch
- Umleitung zur Login-Seite nach fehlgeschlagener Erneuerung
- Klare Fehlermeldungen für Authentifizierungsprobleme
-
Autorisierungsfehlerantwort:
- HTTP 403 Verboten für unzureichende Berechtigungen
- Angemessene Fehlerbehandlung basierend auf Berechtigungsstufe
- Benutzerfeedback für Zugriffsbeschränkungen
-
Allgemeine Fehlerantwort:
- Strukturiertes Fehlerobjekt mit Nachricht und Code
- Angemessener HTTP-Statuscode
- Detaillierte Fehlerinformationen für Debugging
- Benutzerfreundliche Fehlermeldungen für die UI-Anzeige
Integrationsmuster
Clientseitige Integration
- Behandlung von API-Aufrufen aus Client-Komponenten und clientseitigem Rendering
- Verwaltung der Token-Speicherung und -Abruf im Browserkontext
- Implementierung von Anfrage-Interceptoren für Header-Anhängung
- Koordination mit dem Authentifizierungszustandsmanagement
Serverseitige Integration (falls zutreffend)
- Behandlung von API-Aufrufen aus Server-Komponenten
- Sichere Übertragung von Tokens zwischen Server und Client
- Implementierung serverseitiger Token-Validierung
- Angemessene Behandlung serverseitiger Fehlerantworten
React-Komponenten-Integration
- Bereitstellung von Hooks für die API-Kommunikation in funktionalen Komponenten
- Ermöglichung des kontextbasierten API-Client-Zugriffs
- Unterstützung sowohl funktionaler als auch klassischer Komponentenmuster
- Implementierung ordnungsgemäßer Bereinigungs- und Abbruchmechanismen
Sicherheitsaspekte
- Token-Speicherung: Sichere JWT-Token-Speicherung zur Verhinderung von XSS-Angriffen
- Header-Übertragung: Verwendung von HTTPS für alle API-Kommunikationen
- Token-Erneuerung: Implementierung sicherer Token-Erneuerungsmechanismen
- Fehlerinformationen: Vermeidung der Offenlegung sensibler Informationen in Fehlermeldungen
- Anfragevalidierung: Validierung von Anfrageparametern vor dem Senden
- Antwortvalidierung: Überprüfung der Integrität und des Formats der Antwort
- Cross-Site-Anfragen: Implementierung ordnungsgemäßer CORS-Behandlung
Leistungsauswirkungen
- Optimierung des Token-Abrufs und -Anhängens für minimalen Overhead
- Implementierung effizienter Token-Erneuerung zur Vermeidung von Anforderungsblockaden
- Berücksichtigung von Anfrage-Caching-Strategien für verbesserte Leistung
- Minimierung redundanter API-Aufrufe durch ordnungsgemäßes Zustandsmanagement
- Implementierung von Anfrage-Batching, wo angemessen
- Überwachung und Optimierung des Netzwerkanfrage-Timings
Fehlerbehandlung und Validierung
- Validierung des JWT-Token-Formats und -Ablaufs vor Anfragen
- Graceful Handling von Netzwerkkonnektivitätsproblemen
- Implementierung von Wiederholungsmechanismen für vorübergehende Fehler
- Bereitstellung von Fallback-Verhalten für kritische API-Fehler
- Angemessene Protokollierung von Fehlern für Debugging ohne Offenlegung sensibler Informationen
- Implementierung von Circuit-Breaker-Mustern für Dienstresilienz
Testaspekte
- Testen der Token-Anhängungsfunktionalität mit gültigen/ungültigen Tokens
- Überprüfung, ob Token-Erneuerungsmechanismen korrekt funktionieren
- Validierung der Fehlerantwortanalyse über verschiedene Fehlertypen hinweg
- Testen des API-Client-Verhaltens sowohl im Client- als auch im Server-Kontext
- Überprüfung der ordnungsgemäßen Bereinigung und des Abbruchs von Anfragen
- Testen der gleichzeitigen Anforderungsbehandlung und Token-Erneuerungskoordination