API – Autentisering & vägledning

När du autentiserar dig mot det öppna API:t använder du en API nyckel. Du kan skapa hur många nycklar du vill och vi rekommenderar att du skapar en API nyckel per tjänst du integrerar mot.

Exempelkommando:

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://cloud.hostup.se/api/hosting-accounts

Begränsade behörigheter

Om du endast vill ge behörigheter för API nyckeln att göra vissa saker via API, till exempelvis endast hantera DNS poster behöver du endast ge dem de scopes som krävs för detta.

API dokumentation

Du kan hitta vår API dokumenation på https://cloud.hostup.se/api-management. Just nu är den bara tillgänglig när du har loggad in. Dokumenationen är lite begränsad just nu men en sak som är riktigt bra att veta är att vår kundzon använder exakt samma API som du själv som utvecklare har tillgång till.

Det betyder att om du öppnar din webbläsares dev console, kan du se hur API:t används och vilka endpoints som finns tillgängliga.

Ett bra exempel på det är att jag ser när jag öppnade fönstret för att konfigurera behörigheter, gjordes en API call till https://cloud.hostup.se/api/keys/scopes. Där ser jag precis vad sidan hämtar från backend för att kunna skapa den layout du ser på skärmen.

Exempel: Stoppa en VPS

Med hjälp av browser console kan du ta reda på precis allt. Om du provar att stoppa din VPS i kontrollpanelen, kommer du via browser dev console se precis vad som händer. I detta fall skickas en POST begäran iväg till https://cloud.hostup.se/api/vm/16793/status med payload
{action: ”stop”, force: true}. Med denna information kan vi skapa, och testa en curl mot API:t direkt i terminalen:

curl -X POST 'https://cloud.hostup.se/api/vm/16793/status' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"action": "stop", force: true}'

Som svar fick jag tillbaka:

{
    "success": true,
    "timestamp": "2025-11-27T17:32:05.199Z",
    "requestId": "9098d7b0-4cff-40c2-bc43-964500cbde6e",
    "data": {
        "success": true,
        "action": "stop",
        "jobId": "stop-16793-1764264725196",
        "message": "stop operation queued",
        "estimated_time": 30
    }
}

Det är just detta som underlättar extremt mycket för utvecklare hos oss. Eftersom vår kontrollpanel använder exakt samma API som du själv har tillgång till behöver varken vi eller du göra om hjulet. Du behöver inte heller förlita dig på dålig eller föråldrad API dokumentation eftersom du vet att du alltid kan kolla direkt i browser console för att se exakt hur API:t fungerar.

Exempel 2: Hantera automatisk SSL förnyelse via ACHME

Vi har gjort ett plugin till achme.sh:

https://github.com/hostup/acme.sh/blob/9980ad0fef9634b105c59711dd5f470a4b35f080/dnsapi/dns_hostup.sh

Med hjälp av ovan kod får du lite mer exempel på hur du använder vårt API.