Einen Zugriffstoken erhalten

Um mit der Verwendung des APIs zu beginnen, wird zuerst ein Zugriffstoken benötigt. Wie ein solcher Token erhalten werden kann, und wie die API dann hiermit verwendet werden kann, wird auf dieser Seite erklärt.

Grundsätzlich benötigt die API ein Zugangs-Token, um eine Anfrage zu stellen. Das Zugriffstoken ist eine mit dem Nutzer verbundene Authentifizierungsinformation, die den Nutzer bei der Nutzung der API identifiziert und verwaltet, zu welchen Vorgängen der Nutzer für jedes Zugriffstoken berechtigt ist.

Sie können auf einfache Weise Ihr eigenes Zugriffs-Token sowie die Zugriffs-Tokens von nicht spezifizierten Benutzern, die Ihre Anwendung nutzen werden, erhalten.

• Im ersten Fall: Gehe zu „Manuelles Ausstellen Ihres eigenen Zugangstokens “
• Im letzteren Fall: Fahren Sie fort mit ‚Den Benutzer der Anwendung auffordern, ein Zugriffstoken auszustellen‘

Einen Zugriffstoken für das eigene Benutzerkonto generieren

Sie können Ihr eigenes Zugangstoken in Misskey Web unter „Einstellungen > API“ vergeben.

Einen Benutzer zur Generierung eines Zugangstokens für eine Anwendung auffordern

Um das Zugriffstoken eines Benutzers der Anwendung (im Folgenden einfach „Benutzer“ genannt) zu erhalten, verwenden Sie eine der folgenden Methoden.

Nutzung der API

Nach Erhalt des Zugangstokens kann die API durch Anfragen an die verschiedenen Endpunkte genutzt werden.

Methoden mit Autorisierung Header

Geben Sie das Feld „Autorisierung“ im Header wie folgt an.

fetch("https://misskey.example/api/notes/create", {
    method: 'POST',
    body: JSON.stringify({
            text: "Hello Misskey API World with My Application!"
    }),
    headers: {
        Authorization: `Bearer ${accessToken}`,
        'Content-Type': 'application/json',
    },
    credentials: 'omit',
});

Methoden via i

Beispiel für einen Body mit einem Access-Token (für Meta):.

{
    "i": "HogEFugA1341",
    "detail": false
}

Weitere Informationen über die API finden Sie in der API-Referenz.

Misskey bietet nicht nur eine HTTP-API, sondern auch eine Streaming-API an. Für weitere Details, schaue in die [Dokumentation(../streaming/).