{"id":512,"date":"2024-12-28T23:21:19","date_gmt":"2024-12-28T21:21:19","guid":{"rendered":"https:\/\/hostup.se\/support\/?p=512"},"modified":"2025-12-01T15:03:48","modified_gmt":"2025-12-01T13:03:48","slug":"api-autentisering","status":"publish","type":"post","link":"https:\/\/hostup.se\/support\/api-autentisering\/","title":{"rendered":"API \u2013 Autentisering & v\u00e4gledning"},"content":{"rendered":"\n

N\u00e4r du autentiserar dig mot det \u00f6ppna API:t<\/a> anv\u00e4nder du en API nyckel. Du kan skapa hur m\u00e5nga nycklar du vill och vi rekommenderar att du skapar en API nyckel per tj\u00e4nst du integrerar mot.<\/p>\n\n\n\n

Exempelkommando:<\/p>\n\n\n\n

curl -H \"Authorization: Bearer YOUR_API_KEY\" \\\n  https://cloud.hostup.se\/api\/hosting-accounts<\/code><\/pre>\n\n\n\n
\"\"<\/figure>\n\n\n\n
<\/span>Begr\u00e4nsade beh\u00f6righeter<\/span><\/h2>\n\n\n\n
Om du endast vill ge beh\u00f6righeter f\u00f6r API nyckeln att g\u00f6ra vissa saker via API, till exempelvis endast hantera DNS poster beh\u00f6ver du endast ge dem de scopes som kr\u00e4vs f\u00f6r detta.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
<\/span>API dokumentation<\/span><\/h2>\n\n\n\n
Du kan hitta v\u00e5r API dokumenation p\u00e5 https:\/\/cloud.hostup.se\/api-management<\/a>. Just nu \u00e4r den bara tillg\u00e4nglig n\u00e4r du har loggad in. Dokumenationen \u00e4r lite begr\u00e4nsad just nu men en sak som \u00e4r riktigt bra att veta \u00e4r att v\u00e5r kundzon anv\u00e4nder exakt samma API som du sj\u00e4lv som utvecklare har tillg\u00e5ng till.<\/p>\n\n\n\n
Det betyder att om du \u00f6ppnar din webbl\u00e4sares dev console, kan du se hur API:t anv\u00e4nds och vilka endpoints som finns tillg\u00e4ngliga.<\/p>\n\n\n\n
Ett bra exempel p\u00e5 det \u00e4r att jag ser n\u00e4r jag \u00f6ppnade f\u00f6nstret f\u00f6r att konfigurera beh\u00f6righeter, gjordes en API call till https:\/\/cloud.hostup.se\/api\/keys\/scopes. D\u00e4r ser jag precis vad sidan h\u00e4mtar fr\u00e5n backend f\u00f6r att kunna skapa den layout du ser p\u00e5 sk\u00e4rmen.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
<\/span>Exempel: Stoppa en VPS<\/span><\/h2>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Med hj\u00e4lp av browser console kan du ta reda p\u00e5 precis allt. Om du provar att stoppa din VPS i kontrollpanelen, kommer du via browser dev console se precis vad som h\u00e4nder. I detta fall skickas en POST beg\u00e4ran iv\u00e4g 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:<\/p>\n\n\n\n
curl -X POST 'https:\/\/cloud.hostup.se\/api\/vm\/16793\/status' \\\n  -H 'X-API-Key: YOUR_API_KEY' \\\n  -H 'Content-Type: application\/json' \\\n  -d '{\"action\": \"stop\", force: true}'<\/code><\/pre>\n\n\n\n
Som svar fick jag tillbaka:<\/p>\n\n\n\n
{\n    \"success\": true,\n    \"timestamp\": \"2025-11-27T17:32:05.199Z\",\n    \"requestId\": \"9098d7b0-4cff-40c2-bc43-964500cbde6e\",\n    \"data\": {\n        \"success\": true,\n        \"action\": \"stop\",\n        \"jobId\": \"stop-16793-1764264725196\",\n        \"message\": \"stop operation queued\",\n        \"estimated_time\": 30\n    }\n}<\/code><\/pre>\n\n\n\n
Det \u00e4r just detta som underl\u00e4ttar extremt mycket f\u00f6r utvecklare hos oss. Eftersom v\u00e5r kontrollpanel anv\u00e4nder exakt samma API som du sj\u00e4lv har tillg\u00e5ng till beh\u00f6ver varken vi eller du g\u00f6ra om hjulet. Du beh\u00f6ver inte heller f\u00f6rlita dig p\u00e5 d\u00e5lig eller f\u00f6r\u00e5ldrad API dokumentation eftersom du vet att du alltid kan kolla direkt i browser console f\u00f6r att se exakt hur API:t fungerar.<\/p>\n\n\n\n
<\/span>Exempel 2: Hantera automatisk SSL f\u00f6rnyelse via ACHME<\/span><\/h2>\n\n\n\n
Vi har gjort ett plugin till achme.sh: <\/p>\n\n\n\n
https:\/\/github.com\/hostup\/acme.sh\/blob\/9980ad0fef9634b105c59711dd5f470a4b35f080\/dnsapi\/dns_hostup.sh<\/a><\/p>\n\n\n\n
Med hj\u00e4lp av ovan kod f\u00e5r du lite mer exempel p\u00e5 hur du anv\u00e4nder v\u00e5rt API.<\/p>\n\r\n\t\t\t
\r\n\r\n\t\t\t\t
\r\n\t\t\t\t\t
\r\n\t\t\t\t\t\t
Var den h\u00e4r artikeln hj\u00e4lpsam?<\/h3>\r\n\t\t\t\t\t<\/div>\r\n\t\t\t\t\t
\r\n\t\t\t\t\t\t
\r\n\t\t\t\t\t\t\t\r\n\t\t\t
\r\n\t\t\t\t\r\n                \r\n                    \r\n                        
\r\n\t\t\t\t\r\n                \r\n                    \r\n                        
\r\n\t\t\t\t\t
\r\n\t\t\t\t\t\t