Sviluppatori
Orbis Updates espone un’API in sola lettura così che un agente o un integratore consulti le novità pubblicate di Orbis IoT Web, app, API e firmware. Non ci sono chiavi né OAuth: il catalogo pubblico è accessibile con GET. Gli errori usano RFC 9457 (application/problem+json) con code, detail e resolution. Aggiungi ?lang=en|fr|de|it per titoli e riassunti tradotti.
Avvio rapido
- Leggi la specifica su . https://updates.orbis.com.es/openapi.json.
- Elenca i prodotti: GET /api/v1/projects. GET /api/v1/projects
- Elenca le novità: GET /api/v1/releases (filtri project, type, lang, limit, cursor). GET /api/v1/releases
- Firmware per dispositivo: GET /api/v1/firmware/devices. GET /api/v1/firmware/devices
MCP
Il server MCP (Streamable HTTP, senza autenticazione) è su https://updates.orbis.com.es/mcp. Tools: list_projects, list_releases, get_release, get_firmware_devices. La server card è su /.well-known/mcp/server-card.json.
Errori e limiti
Un GET su una risorsa inesistente risponde 404 con application/problem+json. POST e altri metodi rispondono 405. Le risposte includono RateLimit, RateLimit-Policy e RateLimit-Limit (120 richieste / 60 secondi, informativo). CORS è aperto per GET e OPTIONS.
Markdown e llms.txt
Qualsiasi pagina pubblica accetta Accept: text/markdown. L’indice per agenti è /llms.txt e il dump completo /llms-full.txt. Aggiungi ?lang= per la lingua.