3DnaKlik za razvijalce in AI agente

Vse, kar poganja takojšnjo ponudbo, je javen API brez ključa. Programsko pridobite točne cene 3D tiska iz pravega slicerja, ali pa AI asistentu prek našega MCP strežnika prepustite ponudbo in naročilo.

Hiter začetek — REST ponudba v enem klicu

Ocena iz volumna (brez datoteke). Id-je materialov in kakovosti vrne GET /api/config.

curl -X POST https://3dnaklik.si/api/slice \
  -H 'Content-Type: application/json' \
  -d '{"volume_cm3": 25, "material_id": "pla-basic-black", "quality_id": "standard"}'

MCP strežnik — ponudbe iz pravih datotek, za AI agente

Streamable-HTTP MCP končna točka na https://3dnaklik.si/mcp (brez avtentikacije). Orodje create_quote sprejme STL/3MF prek URL-ja ali base64, požene pravi slicer in vrne ceno ter predizpolnjeno povezavo za naročilo. Poleg tega: list_materials, get_service_info.

curl -X POST https://3dnaklik.si/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Strojno berljivi viri

/openapi.json — OpenAPI 3.1 specifikacija (tipizirane sheme, model napak)
/.well-known/mcp/server-card.json — Kartica MCP strežnika
/.well-known/api-catalog — Katalog API-jev (RFC 9727)
/llms.txt — Povzetek strani za LLM-e
/llms-full.txt — Celotna baza znanja za LLM-e
/.well-known/acp.json — Agentic commerce podatki

Napake, omejitve, verzioniranje

Napake so JSON — RFC 9457 problem+json s strojno berljivo kodo in namigom (starejše končne točke vrnejo {"error": "..."}). Neznane /api/* poti vrnejo JSON 404, nikoli HTML.

Odgovori nosijo draft-RFC glavi RateLimit / RateLimit-Policy (npr. 30 zahtev/min na /api/slice); 429 doda Retry-After — prosimo, upoštevajte.

Verzioniranje: API se znotraj glavne različice samo dopolnjuje. Nezdružljive spremembe bi izšle pod /v2 z vsaj 6 meseci prekrivanja, napovedane z glavama Deprecation/Sunset in obvestilom tukaj. Danes ni nič opuščeno.

Vprašanja?

Pišite na info@3dnaklik.si — integracije, višje omejitve in B2B avtomatizacija so dobrodošle.