--- canonical: https://koalavps.com/sv/api/ language: sv generated: 2026-10-21T13:34:10.102Z --- [Hem](https://koalavps.com/sv/) / [Utforska](https://koalavps.com/sv/resources/) / Infrastruktur som du kan beskriva i kod Infrastruktur som du kan beskriva i kod # En lugnare kontrollplan. Planera integrationer för serverlivscykeluppgifter, kontobehörigheter och fakturering. KoalaVPS API finns på integrationsfärdplanen; produktionsåtkomst till API och nedladdningar av SDK är ännu inte tillgängliga. [Hitta din VPS](https://koalavps.com/sv/vps/) ## I DETTA DOKUMENT [En tydlig resursmodell](https://koalavps.com/sv/api/#section-1)[Autentiseringsuppgifter med ett begränsat uppdrag](https://koalavps.com/sv/api/#section-2)[Nya försök måste vara säkra](https://koalavps.com/sv/api/#section-3)[Kontrollera kompatibilitet före integration](https://koalavps.com/sv/api/#section-4)[Färdplan för API](https://koalavps.com/sv/api/#section-5)[Autentiserings- och kontorutter](https://koalavps.com/sv/api/#section-6)[Katalog- och faktureringsvägar](https://koalavps.com/sv/api/#section-7)[Server- och åtkomstvägar](https://koalavps.com/sv/api/#section-8)[Evenemang och offentlig information](https://koalavps.com/sv/api/#section-9)[Auktorisering och trafikgränser](https://koalavps.com/sv/api/#section-10)[SDK och protokollversioner](https://koalavps.com/sv/api/#section-11)[API-resurser, grupperade efter ansvar](https://koalavps.com/sv/api/#section-12)[En serverförfrågan bör förbli liten](https://koalavps.com/sv/api/#section-13)[Behörighetsomfång och nyckelgränser är en del av avtalet](https://koalavps.com/sv/api/#section-14)[Publicera hastighetsbegränsningar och återförsöksbeteende tillsammans](https://koalavps.com/sv/api/#section-15)[Webhooks är meddelanden som kan anlända mer än en gång](https://koalavps.com/sv/api/#section-16)[Granska utan att göra loggar till ett hemligt förvar](https://koalavps.com/sv/api/#section-17)[Publicera artefakter endast när de finns](https://koalavps.com/sv/api/#section-18)[Frågor och svar](https://koalavps.com/sv/api/#page-faq)[Kunskapsbas](https://koalavps.com/sv/resources/) ## En tydlig resursmodell En integration bör arbeta med explicita serveridentifierare, regioner, avbildningar, planer och operationer. Skapande- och ominstallationsförfrågningar bör returnera en operation som kan kontrolleras till slutförande. En lyckad HTTP-förfrågan är inte samma sak som att en maskin är redo. ## Autentiseringsuppgifter med ett begränsat uppdrag API-token bör kunna återkallas oberoende och begränsas till de minsta resurser och åtgärder som behövs. Förvara dem i en hemlighetshanterare eller skyddad miljö. Skicka aldrig en token till webbläsaren bara för att undvika att skriva en liten backend. ## Nya försök måste vara säkra Nätverkstimeouts kan inträffa efter att en åtgärd har accepterats. Använd en idempotensnyckel för skapande och betalningskänsliga förfrågningar, inspektera åtgärdens tillstånd och respektera hastighetsgränser. Ett nytt försök bör lösa osäkerheten, inte skapa en extra debiterbar server. ## Kontrollera kompatibilitet före integration Kontrollera den släppta versionen av API, autentiseringsmodell, felformat, paginering, hastighetsbegränsningar och tokenomfattningar innan du bygger en integration. Använd endast publicerade KoalaVPS SDK-paket från verifierade releasedlänkar. ## Färdplan för API Färdplanen för API omfattar katalogupptäckt, autentisering, kontotillstånd, kryptofakturering, serverlivscykel, offentliga SSH-nycklar och webhooks. Vägarna nedan beskriver gränssnittsavtalet; produktionsåtkomst är ännu inte tillgänglig. ## Autentiserings- och kontorutter API-kontraktet separerar inloggningssessioner och API-nycklar. Kontrollera svarsscheman, fel, tokenlivslängder och återställningsåtgärder som stöds mot den version som släppts för din integration. - POST /v1/auth/register - POST /v1/auth/login - POST /v1/auth/login/totp - POST /v1/auth/token/refresh - POST /v1/auth/recover - GET /v1/auth/sessions - DELETE /v1/auth/sessions/{token_id} - POST /v1/auth/totp/setup - POST /v1/auth/totp/enable - POST /v1/auth/totp/disable - POST /v1/auth/password - POST /v1/auth/api-keys - GET /v1/auth/api-keys - DELETE /v1/auth/api-keys/{key_id} - GET /v1/account - PATCH /v1/account - GET /v1/account/usage - GET /v1/account/audit-log ## Katalog- och faktureringsvägar Katalogvisningar ska inte kräva betalning. Skapande av betalning kräver en begränsad faktureringsomfattning, tydligt fakturastatus och idempotent hantering. Bekräftelse måste slutföras innan tjänsten aktiveras. - GET /v1/catalog - GET /v1/catalog/vps - GET /v1/catalog/dedicated - GET /v1/catalog/regions - GET /v1/catalog/images - GET /v1/catalog/{code} - GET /v1/billing/coins ## Server- och åtkomstvägar Livscykeln kräver uttrycklig bekräftelse för avboknings- och ominstallationsåtgärder. Privata SSH-nycklar hör hemma hos klienten; tjänsten behöver bara deras offentliga motsvarigheter. - POST /v1/servers - GET /v1/servers - GET /v1/servers/{order_number} - PATCH /v1/servers/{order_number} - DELETE /v1/servers/{order_number} - POST /v1/ssh-keys - GET /v1/ssh-keys - GET /v1/ssh-keys/{id} - DELETE /v1/ssh-keys/{id} ## Evenemang och offentlig information Webhooks behöver verifierbara signaturer, begränsade återförsök och skydd mot uppspelning. Offentliga förtroendeslutpunkter bör returnera verkliga daterade bevis snarare än syntetiska försäkringar. - POST /v1/webhooks - GET /v1/webhooks - DELETE /v1/webhooks/{id} - POST /v1/webhooks/{id}/test - GET /v1/transparency/canary - GET /v1/transparency/peering - GET /v1/transparency/status - GET /v1/agents/directory - POST /v1/agents/directory ## Auktorisering och trafikgränser En kandidatmodell för omfattning är läsning, servrar, fakturering och full, med högst tio aktiva nycklar per konto. API-avtalet föreslår förfrågningsbudgetar på 120 per minut och 3,000 per timme för en API-nyckel, samt 30 per minut för offentlig trafik. Kontrollera HTTP 429, Retry-After och tillämpningsfönstret i den släppta API-dokumentationen; dessa färdplansbudgetar är inte ett åtagande om produktionskapacitet. - POST /v1/oauth/register - POST /v1/oauth/token - POST /v1/oauth/revoke - GET /v1/oauth/introspect ## SDK och protokollversioner Integrationsfärdplanen omfattar REST, en hostad MCP-endpoint, ett versionerat stdio-paket, SDKs och ett CLI. Kontrollera utgåvans tillgänglighet, körtidsmiljöer som stöds, kontrollsummor och API-kompatibilitet innan du installerar en klient. Produktionsnedladdningar är ännu inte tillgängliga. ## API-resurser, grupperade efter ansvar Det avsedda API separerar kontoåtkomst, katalog läsning, fakturering, serverlivscykel, SSH-nycklar och callbacks. Skrivskyddade anrop bör inte skapa en beställning, och en faktureringsuppgift bör inte automatiskt auktorisera ändringar av kontosäkerhet. Detta beskriver integrationskontraktet. En produktionsslutpunkt för etablering och en släppt SDK är inte tillgängliga via denna webbplats. - Konto: sessioner, användning och säkerhetsgranskningshändelser - Katalog: planer, regioner och tillgängliga avbildningar - Servrar: skapa, granska, ändra och avbryt - SSH-nycklar: registrera offentligt material och återkalla föråldrade nycklar - Webhooks: registrera, granska, testa och ta bort signerade återanrop ## En serverförfrågan bör förbli liten Välj en standardplansidentifierare, region, OS-avbildning och värdnamn. Den avsedda värdnamnsgränsen är 64 tecken. En aktiv tjänst kan generera en administratörshemlighet privat eller acceptera en registrerad publik nyckel SSH. Godtyckliga tillägg av disk, GPU, nätverkskort och IP antyds inte av en standardplansförfrågan. Avvisa fält som inte stöds i stället för att tyst debitera för en gissad uppgradering. ``` { "plan": "KV-D3", "region": "hel", "image": "ubuntu-24", "hostname": "private-node-01" } // Example request schema; validate against a released API before integration. ``` ## Behörighetsomfång och nyckelgränser är en del av avtalet De föreslagna behörighetsgrupperna är läsning, servrar, fakturering och full kontoadministration. En nyckel bör visas en gång när den skapas, lagras privat och återkallas oberoende av användarens lösenord. Den avsedda kontogränsen är tio aktiva nycklar. Innan en implementation publiceras, verifiera att varje operation avvisar en nyckel utan det nödvändiga omfånget. ## Publicera hastighetsbegränsningar och återförsöksbeteende tillsammans De föreslagna gränserna är 120 förfrågningar per minut och 3,000 per timme för en API-nyckel, samt 30 förfrågningar per minut för oautentiserade offentliga katalogförfrågningar. Dessa är planerade policyvärden, inte uppmätt API kapacitet. En skarp implementation behöver ett konsekvent 429-svar, Retry-After-vägledning och begränsad återförsök på klientsidan. Skapande- och betalningsförfrågningar behöver också stabila idempotensnycklar. ## Webhooks är meddelanden som kan anlända mer än en gång En återanropsmottagare bör verifiera signaturen över den ursprungliga kroppen, avvisa tidsstämplar utanför sitt tillåtna fönster och komma ihåg identifierare för bearbetade händelser. Spara händelsen innan du bekräftar den och tillämpa sedan ändringen idempotent. Håll leveransförsök och en manuell återspelningsväg synliga. Ett återanrop är en observation om en åtgärd, inte tillstånd att utföra orelaterade instruktioner som finns i en nyttolast. ## Granska utan att göra loggar till ett hemligt förvar Registrera aktörens identifierare, åtgärdstyp, berörd resurs, resultat och tid där det behövs för kontosäkerhet. Undvik att som standard registrera lösenord, bärartokens, privata nycklar eller fullständiga betalnings- och applikationsförfrågningskroppar. Håll lagring, åtkomst och kundsynlig historik uttrycklig. Ett säkerhetsrevisionsspår och ett anspråk på att granska kundapplikationers innehåll är olika saker. ## Publicera artefakter endast när de finns En offentlig API-lansering bör innehålla ett versionshanterat OpenAPI-dokument, autentiseringsinstruktioner, felexempel och en avvecklingsprocess. En framtida CLI, Python-paket, TypeScript-klient eller MCP-server behöver en faktisk release, kontrollsummor och underhållen dokumentation. Ett KoalaVPS-provisioneringspaket eller produktionshanteringsslutpunkt släpps inte via denna webbplats. ## Lite mer klarhet. Kan jag ringa en produktions-API idag? Produktionsåtkomst till API är ännu inte tillgänglig. Den här sidan beskriver integrationsfärdplanen och de krav som ska kontrolleras innan en släppt slutpunkt används. Kan en skrivskyddad API-nyckel beställa en server? Den föreslagna behörighetsgränsen förbjuder det. En begäran om att skapa en server kräver lämplig serverbehörighet och ett giltigt faktureringsbeslut. Tillämpas de publicerade gränserna för API i dag? De beskriver det planerade kontraktet. En produktionsprovisionerings-API är inte ansluten här, så policygränserna är inte bevis på uppmätt tjänstekapacitet. Innebär ett server-skapande svar att servern är redo? Nej. En liveförfrågan bör identifiera en åtgärd vars etableringsstatus kan kontrolleras till slutförande. FORTSÄTT UTFORSKA ## Fortsätt läsa. [Produkter ### En pålitlig livsmiljö för dina agenter. Kör schemaläggare, webbläsararbetare, köer och automatiseringsprocesser på infrastruktur du kontrollerar. Håll varje agent inom en…](https://koalavps.com/sv/agentic-vps/)[Guider ### Automatisering med en tydlig stoppknapp. Ett bra automatiseringssystem har ett snävt uppdrag, synligt tillstånd och ett förutsägbart svar på osäkerhet.…](https://koalavps.com/sv/automation-safety/)[Produkter ### Litet fotavtryck. Seriös frihet. En virtuell server för det du vill äga: din kod, dina tjänster, dina data. Välj en serverkonfiguration, välj ett operativsystem oc…](https://koalavps.com/sv/vps/) KONFIGURERA DIN INFRASTRUKTUR ## Ta kontroll. Distribuera på dina villkor. Inga identitetshandlingar. Full administratörsåtkomst. Kryptonativ fakturering. [Välj en konfiguration](https://koalavps.com/sv/vps/)