Panoramica dell'API

L’API Seyval ti consente di gestire repository, eseguire analisi del codice, eseguire codice e configurare integrazioni in modo programmatico. Tutti gli endpoint utilizzano JSON su HTTPS.

URL base

https://api.seyval.dev

Versionamento

Tutti gli endpoint delle risorse hanno il prefisso /v1. Gli endpoint OAuth e di discovery non sono versionati.

Autenticazione

La maggior parte degli endpoint richiede un token Bearer. Passalo nell’header Authorization:

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.seyval.dev/v1/repositories

Puoi creare e gestire le chiavi API dal pannello di controllo o tramite gli endpoint delle chiavi API.

Formato delle risposte

Tutte le risposte restituiscono JSON. Le risposte di successo utilizzano codici di stato HTTP standard:

Codice	Significato
`200`	Successo
`201`	Risorsa creata
`204`	Successo senza corpo risposta
`422`	Errore di validazione

Risposte di errore

Gli errori di validazione restituiscono uno stato 422 con dettagli sui campi che hanno fallito la validazione:

{
  "detail": [
    {
      "loc": ["body", "field_name"],
      "msg": "description of the error",
      "type": "error_type"
    }
  ]
}

Quale risorsa di calcolo ha usato una run

Due campi descrivono la risorsa di calcolo di una run e rispondono a domande diverse:

Campo	Domanda a cui risponde
`compute_id`	Quale destinazione — `managed:<tier>` o `byo:<uuid>`.
`compute_type`	Che tipo di macchina ha effettivamente eseguito la run.

In una run gestita i due coincidono: ottieni il tier richiesto, quindi compute_type è quel tier (gpu-h100). Su un cluster BYO non coincidono. compute_type riporta il modello di GPU che il cluster stesso ha dichiarato — il tipo GRES di sinfo, per esempio nvidia_gb200 — oppure unknown se il cluster non ne ha dichiarato alcuno. È quindi una stringa libera, non un insieme fisso di valori. Il compute_type che invii per avviare una run significa un’altra cosa: è ciò che richiedi e, su un cluster BYO, porta un tier di compatibilità usato per derivare la richiesta di GPU. Richiedere e registrare sono valori distinti, e su BYO differiscono.

URL di download

Gli endpoint che restituiscono il contenuto dei file — i log di una esecuzione (stdout_url / stderr_url) e i suoi artefatti (download_url) — restituiscono URL prefirmati di breve durata anziché i byte stessi. Ognuno è valido al massimo un’ora dal momento in cui viene emesso, e gli URL dei log sono serviti da una cache, quindi il tempo residuo può essere inferiore. Non conservare questi URL: un URL salvato restituirà poi soltanto Request has expired. Conserva invece il run_id (e il percorso del file) e richiedi un URL nuovo quando ti serve davvero il file:

# Riemettere e scaricare nello stesso passaggio
curl -sSL "$(curl -sS -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.seyval.dev/v1/runs/RUN_ID | jq -r .stdout_url)" -o stdout.txt

Gruppi di endpoint

Usa la barra laterale per esplorare tutti gli endpoint disponibili, organizzati per gruppo:

Repository — registrare, elencare e gestire i repository
File del repository — esplorare i file all’interno di un repository
Analisi del codice — avviare, monitorare e gestire le analisi del codice
Esecuzione del codice — eseguire codice e recuperare i risultati dell’esecuzione
Streaming di esecuzione — trasmettere log stdout/stderr in tempo reale tramite SSE
Chiavi API — creare e revocare chiavi API
Variabili d’ambiente — gestire le variabili d’ambiente per l’esecuzione
Integrazione GitHub — connettere e gestire i repository GitHub
GitHub App Webhooks — ricevere eventi push e pull request per l’analisi automatizzata
OAuth 2.0 — autorizzazione, token e registrazione client

​URL base

​Versionamento

​Autenticazione

​Formato delle risposte

​Risposte di errore

​Quale risorsa di calcolo ha usato una run

​URL di download

​Gruppi di endpoint