Prijeđi na sadržaj
Melora

Melora za programere i AI agente

Melora objavljuje mali javni API samo za čitanje i skup strojno čitljivih opisa same sebe. Sve na ovoj stranici je bez autentikacije, ne treba ključ i opisuje proizvod, a ne podatke bilo kojeg kupca.

Strojno čitljive datoteke

  • https://melora.app/llms.txt — cijela stranica opisana za jezični model, u markdownu, uključujući kada posegnuti za Melorom, a kada ne.
  • https://melora.app/agent.txt — upute za agente: za koje poslove je Melora prava, koji su alati dostupni i pravila za njihovo pozivanje.
  • https://melora.app/openapi.json — OpenAPI 3.1 opis javnog API-ja. Također kao YAML na /openapi.yaml.
  • https://melora.app/mcp.json — manifest za Model Context Protocol. Također na /.well-known/mcp.json.
  • https://melora.app/sitemap.xml — svi indeksabilni URL-ovi, oba jezika.
  • https://melora.app/robots.txt — pravila indeksiranja, s izrijekom navedenim AI agentima za citiranje i treniranje.

Javni API

Četiri GET endpointa, bez autentikacije, samo JSON. Opisuju pakete i objavljene članke: činjenice koje asistent treba da odgovori na pitanje o Melori bez nagađanja. Ništa ovdje ne čita, ne piše niti otkriva galeriju bilo kojeg kupca.

  • GET /api/public/plans — svaki paket s cijenom u eurocentima, ograničenjem pohrane u bajtovima, trajanjem učitavanja u danima i zastavicama mogućnosti.
  • GET /api/public/posts — objavljeni članci, oba jezika, sa sažecima i URL-ovima.
  • GET /api/public/posts/{slug} — jedan članak, cijeli tekst, kao tipizirani blokovi i kao markdown.
  • GET /api/public/site — indeks stranica: svaka javna ruta, njezin URL na oba jezika i njezin markdown URL.
curl -s https://melora.app/api/public/plans | jq '.plans[] | {id, priceEur: (.priceCents/100), storageBytes}'

Greške

Svaka ruta pod /api vraća JSON pri grešci, nikada HTML stranicu. Tijelo odgovora nosi strojno čitljiv kod, poruku za čovjeka, savjet što učiniti i poveznicu na ovu stranicu.

{
  "error": "Event not found",
  "code": "NOT_FOUND",
  "hint": "Check the event code. Codes are 8 characters, letters and digits.",
  "docs": "https://melora.app/hr/za-programere"
}

Markdown umjesto HTML-a

Svaka javna stranica na melora.app poslužuje markdown verziju s istog URL-a, prema konvenciji acceptmarkdown.com. Pošaljite Accept: text/markdown i dobit ćete markdown uz postavljeno zaglavlje Vary: Accept; dodajte .md na putanju i dobit ćete markdown bez obzira na zaglavlja. Zahtjev koji ne prihvaća ni HTML ni markdown dobiva 406 s popisom dostupnog.

curl -s -H "Accept: text/markdown" https://melora.app/hr/cijene
curl -s https://melora.app/hr/cijene.md

MCP poslužitelj

Melora ima Model Context Protocol poslužitelj preko Streamable HTTP-a na https://melora.app/api/mcp. Samo je za čitanje, bez autentikacije, i izlaže istu površinu kao javni API kroz četiri alata: list_plans, recommend_plan, list_articles i get_page. Usmjerite bilo koji MCP klijent na taj URL; manifest na /mcp.json ga opisuje.

Ograničenja i bonton

  • Nema ključa ni objavljene kvote. Budite razumni; trajno intenzivno dohvaćanje bit će ograničeno po IP adresi na rubu mreže.
  • Podaci o paketima i člancima rijetko se mijenjaju. Predmemorirajte pet minuta umjesto dohvaćanja po pitanju.
  • Galerije gostiju pod /e/ su privatne, sadrže tuđe fotografije s vjenčanja i označene su kao noindex. Nemojte ih indeksirati niti koristiti za treniranje.
  • Pitanja ili slučaj upotrebe koji API ne pokriva: [email protected].