Erste Schritte

API-Referenz

Binden Sie die Dienste von Nebux in Ihre eigenen Anwendungen ein

Überblick

Mit der Nebux-API steuern Sie alle Dienste von Nebux programmatisch. Die meisten Operationen laufen über einen einzigen GraphQL-Endpoint; die KI-Inferenz bietet zusätzlich eine OpenAI-kompatible REST-API.

GraphQL-Endpoint

URL

https://api.nebux.cloud

MethodPOST

Content-Typeapplication/json

Authentifizierung

Jede Anfrage muss einen gültigen API-Schlüssel als Bearer-Token im Authorization-Header enthalten. Ein Schlüssel hat genau die Berechtigungen, die an ihn vergeben wurden, und alles außerhalb davon antwortet so, als würde es nicht existieren. Ihre API-Schlüssel und das, was jeder einzelne darf, verwalten Sie im Dashboard.

HeaderAuthorization: Bearer your-api-key

API keysAPI-Schlüssel verwalten

Anfrageformat

GraphQL-Anfragen sind JSON-Objekte mit einem Feld query (dem GraphQL-Dokument) und einem optionalen Feld variables.

body.json

{
  "query": "query GetIssue($id: ID!) { issue(id: $id) { id friendlyId title status } }",
  "variables": { "id": "rprdbtyvc51ys7g7xq9xwra8cm" }
}

Eine Anfrage senden

Die GraphQL-API von Nebux funktioniert mit jedem HTTP-Client. Sie brauchen keine spezielle Bibliothek: Senden Sie einfach eine POST-Anfrage mit einem JSON-Body. Die Beispiele unten zeigen eine einfache Query in der Programmiersprache Ihres Projekts.

index.ts

const res = await fetch("https://api.nebux.cloud", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer your-api-key",
  },
  body: JSON.stringify({
    query: `query GetIssue($id: ID!) { issue(id: $id) { id friendlyId title status } }`,
    variables: { id: "rprdbtyvc51ys7g7xq9xwra8cm" },
  }),
})

const { data } = await res.json()
console.log(data.issue.title)

Tipp: Wenn Sie lieber einen typisierten GraphQL-Client verwenden: Bibliotheken wie graphql-request (JS/TS) oder gql (Python) funktionieren mit diesem Endpoint ohne weitere Anpassung.