Primi passi

Riferimento API

Integra i servizi di Nebux nelle tue applicazioni

Panoramica

L'API di Nebux ti permette di interagire con tutti i servizi di Nebux in modo programmatico. La maggior parte delle operazioni è esposta tramite un unico endpoint GraphQL; il servizio di inferenza IA offre inoltre un'API REST compatibile con OpenAI.

Endpoint GraphQL

URL

https://api.nebux.cloud

MethodPOST

Content-Typeapplication/json

Autenticazione

Tutte le richieste devono includere una chiave API valida come token Bearer nell'header Authorization. Una chiave ha esattamente i permessi che le sono stati concessi, e tutto ciò che ne resta fuori risponde come se non esistesse. Puoi gestire le tue chiavi API e ciò che ciascuna può fare dal pannello.

HeaderAuthorization: Bearer your-api-key

API keysGestisci le chiavi API

Formato della richiesta

Le richieste GraphQL sono oggetti JSON con un campo query (il documento GraphQL) e un campo variables facoltativo.

body.json

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

Fare una richiesta

L'API GraphQL di Nebux funziona con qualsiasi client HTTP. Non serve nessuna libreria speciale: invia semplicemente una richiesta POST con un corpo JSON. Gli esempi qui sotto mostrano come fare una query semplice nel linguaggio del tuo progetto.

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)

Suggerimento: Se preferisci un client GraphQL tipizzato, librerie come graphql-request (JS/TS) o gql (Python) funzionano direttamente con questo endpoint.