RoastnetRoastnet

Market API a MCP

Prepojte váš sklad či AI s trhom zelenej kávy.

Sledujte šarže zelenej kávy na Roastnete v reálnom čase, reagujte na objednávky či vzorky a nechajte AI riešiť úlohy vo vašom účte.

REST API

Jedným kľúčom ovládate celý predaj.

V konzole Roastnet si vygenerujete kľúč, ktorý použijete ako Bearer token. API pokrýva šarže, objednávky, vzorky, ponuky a udalosti, s webhookmi pre okamžité informácie o zmenách.

curl https://network.roastnet.ai/api/market/v1/lots \
  -H "Authorization: Bearer rnk_YOUR_KEY"
  • 01Vypisujte, synchronizujte, upravujte či stiahnite šarže podľa vlastného kódu.
  • 02Potvrďte, zamietnite alebo označte objednávky ako odoslané a doručené.
  • 03Prezrite žiadosti o vzorky a označte vzorky ako odoslané.
  • 04Až 120 dotazov za minútu na kľúč, odpoveď 429 vás informuje, kedy skúsiť znovu.

AI agenti (MCP)

Prepojte vášho AI asistenta.

Roastnet prevádzkuje server Model Context Protocol pre zelený trh. S MCP klientom môže váš asistent prehľadávať trh, zadávať, upravovať a sťahovať šarže podľa vlastného kódu, prezerať objednávky, ponuky a žiadosti o vzorky, označiť vzorku ako odoslanú, podľa rovnakých pravidiel ako API.

  1. Vstúpte na zelený trh zadarmo alebo sa prihláste do konzoly Roastnet.
  2. V Connect agentovi vytvorte token pre svojho asistenta.
  3. Pridajte server nižšie do MCP klienta a skopírujte token.

Konfigurácia MCP klienta (JSON)

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

Alebo cez príkazového klienta

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

Vaše YOUR_TOKEN nahradíte tokenom z Connect agenta. Tokeny je možné kedykoľvek zrušiť na rovnakom mieste.

Pre stroje

Navrhnuté pre automatické objavenie.

Agenti a scrappery vždy nájdu všetko: MCP server card pod /.well-known/mcp.json, prehľad v texte na /llms.txt a OpenAPI odkaz na tejto stránke.

Otázky

Na čo sa nás pýtate.

Kto môže používať Market API?
Každý podnik predávajúci na zelenom trhu Roastnet, vrátane importérov, pražiarní a exportérov, ak sa pridá a vytvorí kľúč v konzole.
Ako funguje autentifikácia?
REST API používa API kľúč ako Bearer token. MCP server používa token, ktorý vytvoríte v Connect agentovi, tiež ako Bearer token.
Kde je OpenAPI špecifikácia?
Na adrese network.roastnet.ai/api/market/v1/openapi.json. Je verejná a nevyžaduje kľúč.

Podmienky Market API

Vaše šarže tam, kde hľadajú vaši kupujúci.

Vstúpte na zelený trh zadarmo, vytvorte si kľúč a prepojte systém ešte dnes.