RoastnetRoastnet

Market API e MCP

Collega il tuo sistema o AI al mercato del caffè verde.

Mantieni i tuoi lotti verdi su Roastnet aggiornati con il tuo sistema, gestisci ordini e richieste di campioni appena arrivano, lascia che un’assistente AI lavori per te.

Leggi la documentazione API Entra nel mercato del caffè verde gratis

REST API

Una chiave, tutto il lato vendita.

Crea una chiave nella console Roastnet e inviala come Bearer token. L’API gestisce lotti, ordini, campioni, offerte e un feed di eventi con webhooks per notifiche istantanee ad ogni cambiamento.

curl https://network.roastnet.ai/api/market/v1/lots \
  -H "Authorization: Bearer rnk_YOUR_KEY"
  • 01Elenca, sincronizza, aggiorna e ritira lotti tramite il tuo riferimento.
  • 02Conferma, rifiuta e segna gli ordini come spediti e consegnati.
  • 03Consulta le richieste di campioni e segnala i campioni inviati.
  • 04Fino a 120 richieste al minuto per chiave; la risposta 429 indica quando riprovare.

Agenti AI (MCP)

Collega il tuo assistente AI.

Roastnet offre un server Model Context Protocol per il mercato del caffè verde. Collega qualsiasi client MCP: il tuo assistente gestirà i lotti, leggerà ordini, offerte e richieste di campioni, segnerà i campioni inviati, seguendo le stesse regole dell’API.

  1. Accedi gratis al mercato del caffè verde, o entra nella console Roastnet.
  2. Apri Connect agent e crea un token per il tuo assistente.
  3. Aggiungi il server sotto al tuo client MCP e incolla il token.

Configurazione client MCP (JSON)

{
  "mcpServers": {
    "roastnet-market": {
      "type": "http",
      "url": "https://network.roastnet.ai/api/network/fitter-mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Oppure da un client da terminale

claude mcp add --transport http roastnet-market \
  https://network.roastnet.ai/api/network/fitter-mcp \
  --header "Authorization: Bearer YOUR_TOKEN"

Sostituisci YOUR_TOKEN con il token ottenuto in Connect agent. I token possono essere revocati in qualsiasi momento dallo stesso menu.

Per macchine

Progettata per essere individuata.

Agenti e crawler trovano tutto da soli: la card server MCP su /.well-known/mcp.json, una panoramica testuale semplice su /llms.txt e la documentazione OpenAPI disponibile in questa pagina.

Domande

Le domande più frequenti.

Chi può usare la Market API?
Qualsiasi attività che vende sul mercato del caffè verde Roastnet, inclusi importatori, torrefazioni ed esportatori, dopo aver aderito e creato una chiave nella console.
Come funziona l’autenticazione?
La REST API usa una chiave API inviata come Bearer token. Il server MCP utilizza un token creato in Connect agent, anch’esso inviato come Bearer token.
Dove si trova la specifica OpenAPI?
Su network.roastnet.ai/api/market/v1/openapi.json. È pubblica e non richiede chiave.

Condizioni Market API

Anche nel mercato del caffè verde

Tutte le realtà riunite dal mercato.

Acquista caffè verde Lotti di origine, importatori e torrefattori in un unico posto.Vendi eccedenze di verde Torrefazioni: vendi il verde che non tosterai.Per importatori Inserisci i tuoi lotti, mantieni i clienti e fatturali direttamente.Per coltivatori ed esportatori Vendi direttamente ai torrefattori specialty, con Roastnet che gestisce tutto il resto.

I tuoi lotti dove cercano i tuoi clienti.

Unisciti gratis al mercato del caffè verde, crea una chiave e collega il tuo sistema in 48 ore.

Iscriviti gratis Documentazione API completa