API pubblica

EvalRank espone sette route anonime basate prima di tutto sulla ricevuta. Così ogni documento di successo e ogni errore RFC 9457 lo puoi verificare rispetto al contratto pubblico fissato.

POST /v1/decisions usa share=false come impostazione predefinita, quindi la ricevuta che ricevi non viene conservata. Con share=true, la query identica viene conservata con il suo ID ricevuta content-addressed e la puoi riprodurre tramite URL.

Le classifiche per capacità restano separate per gruppo di classifica comparabile. Una decisione ti restituisce un top set supportato oppure si astiene: non inventa mai un unico vincitore.

Route

  • POST /v1/decisions

    Valuta una singola query di decisione esatta. Aggiungi share=true solo quando vuoi una ricevuta conservata e adatta alla pubblicazione.

  • GET /v1/decisions/{receipt_id}

    Riproduci una ricevuta conservata tramite il suo ID content-addressed.

  • GET /v1/benchmark-health

    Controlla la copertura dei benchmark attivi, in anteprima e non disponibili, senza dichiarare morta una fonte.

  • GET /v1/use-cases

    Consulta il catalogo canonico delle celle di capacità.

  • GET /v1/leaderboard/{use_case}

    Leggi i gruppi di classifica di una singola cella di capacità canonica, senza appiattire sistemi diversi tra loro.

  • GET /v1/entities/{entity_type}/{slug}

    Leggi una singola configurazione valutata esatta, con passaporto, classifica e citazioni.

  • GET /v1/compare

    Confronta da due a quattro configurazioni di uno stesso gruppo di classifica e snapshot.

Leggi la metodologia