För AI-assistenter

Hela API:t i ett dokument

Komplett specifikation av Asstios REST + MCP API — endpoints, schemas, autentisering, exempel och versionskontrakt — i ett enda dokument optimerat för LLMs. Klistra in i Claude, Cursor eller ChatGPT och få hjälp att bygga integrationer direkt.

 Ladda ner som .md

Direktlänk: https://www.asstio.com/llms-api.txt

Asstio API-spec för AI
Tre sätt att använda

Ge er AI-assistent full kontext om Asstio

1. Klistra in i chatten

Klicka "Kopiera hela specen" ovan, klistra in i Claude / ChatGPT som ett system- eller user-message. AI:n får komplett kunskap om alla endpoints och kan hjälpa er bygga integrationer direkt.

2. Länka direkt

Be Claude eller en assistent med web-access att hämta /llms-api.txt. Med Claude.ai: "Fetch https://www.asstio.com/llms-api.txt och hjälp mig bygga…". Med Cursor: lägg URL:en som @docs.

3. Koppla via MCP istället

Behöver assistenten faktiskt köra anrop — inte bara förstå API:t — använd Asstios MCP-server direkt. Då exponeras varje endpoint som ett verktyg. Se MCP-setup →

Vad ingår

Specen täcker hela v1

Ett enda Markdown-dokument med allt en LLM behöver för att resonera om eller generera kod mot Asstio.

1Översikt & base URLs 2Autentisering (3 flöden) 3Konventioner & paginering 410 endpoints med schemas 5MCP-konfiguration 6Versions­kontrakt 7Use cases för LLM-prompts 8Vad som inte finns i v1
Färdiga prompts

Tre exempel på hur ni öppnar Claude med Asstios spec

PROMPT Power BI-dashboard
Här är Asstios API-spec:

[klistra in /llms-api.txt här]

Hjälp mig bygga en C# .NET 9-konsolapp
som hämtar alla öppna säljordrar och
sparar dem som CSV för Power BI-import.
Använd Bearer-auth via app-lösenord.
PROMPT Slack-bot
Du har tillgång till Asstios API
(spec nedan). Skriv ett Node.js-script
som körs nattligt och postar till Slack
om någon orderrad i open-order-lines
ligger 30+ dagar utan delleverans.

[klistra in /llms-api.txt här]
PROMPT Analytisk fråga
Här är Asstios API. Vilka endpoints
behöver jag kombinera för att svara
på frågan: "Vilka 5 kunder hade
högst snittfaktura senaste kvartalet,
och vad köpte de mest av?"

[klistra in /llms-api.txt här]
Förhandsvisning

Specen i sin helhet

Samma dokument som ligger på /llms-api.txt — här visat med rubrikstruktur så ni kan skumma innan ni kopierar.

1. Översikt

REST under /api/v1/* för servrar och script. MCP-server för Claude, Cursor, Cline. Samma data, samma auth, samma versionskontrakt.

REST base: https://<tenant>.asstio.com/api/v1
MCP base: https://<tenant>-mcp.asstio.com/mcp

<tenant> härleds automatiskt från tokens InstanceId-claim — passa aldrig manuellt.

2. Autentisering

Tre olika flöden — ett per användartyp.

  • Servrar / cron-jobb: Skapa app-lösenord i Asstio → växla mot Zitadel-token → cacha → använd som Authorization: Bearer.
  • In-browser: Token finns redan i Asstio-sessionen.
  • AI-assistenter: OAuth-discovery enligt RFC 9728 — Claude Desktop / Cursor sköter det själva.

3. Konventioner

  • ISO 8601 UTC, UTF-8, RFC 7807 felformat
  • Cursor-baserad paginering: nextCursor i responsen → ?cursor=… i nästa request
  • Default pageSize = 50, max 500
  • Versionsheader X-Asstio-Api-Version: v1 på varje response
  • REST: inga rate-limits. MCP: 60 tool-calls/min/användare.

4. Endpoints (10 st)

Alla read-only i v1. En MCP-tool per endpoint.

MethodPathMCP tool
GET/sales-orderslist_sales_orders
GET/purchase-orderslist_purchase_orders
GET/sales-invoiceslist_sales_invoices
POST/sales-invoice-lineslist_sales_invoice_lines
GET/open-order-lineslist_open_order_lines
GET/warehouse-stockget_warehouse_stock
GET/vendor-pricesget_vendor_prices_for_product
GET/products/findfind_product
GET/customerslist_customers
GET/customers/{id}get_customer

Varje endpoint i den fulla specen har komplett query-parameter-lista och response-schema med fältnamn, typer och exempelvärden.

5. MCP-konfiguration

Claude Desktop, Cursor och Cline — alla använder samma claude_desktop_config.json-pattern. Custom-klienter kan upptäcka servern via RFC 9728 OAuth Protected Resource discovery på /.well-known/oauth-protected-resource.

6. Versions­kontrakt

Inuti v1: bara additiva ändringar. Fältnamn, typer och default-beteenden ändras inte. Breaking changes landar på /api/v2/*. v1 fortsätter köra tills sista integratorn migrerat.

7. Use cases för LLM-prompts

Specen avslutas med 6 konkreta exempelfrågor och vilka endpoints en LLM ska kombinera för att svara på dem — bra som few-shot-context för era egna agenter.

8. Vad som inte finns i v1

  • Skrivande operationer (POST/PUT/DELETE av affärsdata) — kommer i v2.
  • Bokföringsdata (huvudbok, kontoplan) — kommer i v1.x.
  • Lön — under utveckling.
  • Lagerrörelser detaljerat (bara aktuella saldon idag).
  • Bilagor och dokument.
Få access

Redo att låta er AI prata med Asstio?

Kontakta oss för app-lösenord, tenant-URL och MCP-endpoint — och säg gärna vad ni vill bygga, så pekar vi mot rätt endpoints och prompts.

Kontakta oss Tillbaka till /api →