Wie integriere ich eine externe API in meinen Alexa Skill?

Gestern

Melden

Verstehen der Infrastruktur von Alexa Skills
Backend einrichten und HTTP-Anfragen ausführen
Authentifizierung und API-Zugriff
Asynchrone Programmierung im Alexa Skill
Fehlerbehandlung und Timeout
Implementierungsbeispiel in Node.js
Zusammenfassung

Die Integration einer externen API in einen Alexa Skill ermöglicht es dir, dynamische Inhalte und Funktionen in deinen Skill einzubinden, die über die vorgefertigten Intents und Antworten hinausgehen. Im Folgenden erläutere ich ausführlich, wie du eine externe API in deinen Alexa Skill integrieren kannst.

Verstehen der Infrastruktur von Alexa Skills

Alexa Skills basieren entweder auf AWS Lambda Funktionen oder auf einem eigenen Webservice, der HTTPS unterstützt. Deine Logik, wie die Sprachbefehle verarbeitet und beantwortet werden, wird in diesem Backend ausgeführt. Um eine externe API zu nutzen, musst du von deinem Skill-Backend aus HTTP-Anfragen an die gewünschte API senden und die erhaltenen Daten verarbeiten.

Backend einrichten und HTTP-Anfragen ausführen

Wenn du deinen Skill mit AWS Lambda erstellst, kannst du in der Lambda-Funktion die API-Anfragen programmieren. Üblicherweise verwendest du Node.js für Alexa Skills. Dort stehen dir verschiedene Module zur Verfügung, um HTTP-Anfragen zu stellen, wie zum Beispiel https, http, axios oder node-fetch.

Ein Beispiel: Möchtest du Wetterdaten von einer externen REST-API abrufen, baust du in deinem Lambda Handler eine Funktion ein, die während der Ausführung eine Anfrage an den API-Endpunkt sendet, die Antwort erhält, gegebenenfalls im JSON-Format verarbeitet und dann die relevanten Informationen als Antwort über Alexa ausgibt.

Authentifizierung und API-Zugriff

Viele externe APIs erfordern eine Authentifizierung, oft über API-Schlüssel, OAuth-Token oder andere Methoden. Diese Schlüssel solltest du niemals im Klartext ins Frontend speichern, sondern sicher in deinem Backend verwalten, etwa als Umgebungsvariable in AWS Lambda. Beim Aufruf der API fügst du dann die nötigen Header oder Parameter hinzu, um autorisierten Zugriff zu erhalten.

Asynchrone Programmierung im Alexa Skill

Da HTTP-Anfragen Zeit benötigen, sollte dein Code asynchron programmiert sein, um Wartezeiten zu handhaben. In Node.js verwendest du dazu async/await oder Promises. Nur wenn die Antwort der externen API vorliegt, kannst du die Antwort an Alexa zurückgeben, weshalb die Lambda-Funktion auf die vollständige Bearbeitung der Anfrage warten muss.

Fehlerbehandlung und Timeout

Es ist wichtig, Fehlerfälle beim Kontakt mit der externen API sinnvoll abzufangen. Die API könnte nicht erreichbar sein, langsame Antwortzeiten liefern oder unerwartete Daten zurückgeben. Du solltest Timeout-Mechanismen definieren und im Fehlerfall dem Nutzer verständliche und hilfreiche Rückmeldungen geben, um eine gute User Experience sicherzustellen.

Implementierungsbeispiel in Node.js

Angenommen, du möchtest eine externe Wetter-API in deinem Skill nutzen. Hier ein minimalistischer Ausschnitt, wie es aussehen könnte:

const https = require(https);async function getWeather(city) { const apiKey = process.env.WEATHER_API_KEY;

const url = `https://api.weatherprovider.com/data?city=${encodeURIComponent(city)}&apikey=${apiKey}`;

return new Promise((resolve, reject) => { https.get(url, (res) => { let data = ; res.on(data, chunk => data += chunk); res.on(end, () => { try { const parsedData = JSON.parse(data); resolve(parsedData); } catch (e) { reject(new Error(Fehler beim Parsen der API-Daten.)); } }); }).on(error, (e) => { reject(e); }); });}// In deinem Intent-Handler verwendest du dann:const city = Berlin;const weatherData = await getWeather(city);// Verarbeite weatherData und baue eine Antwort für Alexa