VPS.org API

REST API-dokumentation

Platser API

Ange platser där du kan distribuera en VPS. Skicka en platss ID som location_id när du skapar en server.

Slutpunkter 2 endpoints
Basväg /api/v1/locations
FÅ /api/v1/locations/

Lista alla platser

Hämta en lista över alla tillgängliga datacenter platser där du kan distribuera VPS-servrar.

Exempelförfrågan

cURL
Python
JavaScript
PHP
curl -X GET "https://admin.vps.org/api/v1/locations/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"
import requests

url = "https://admin.vps.org/api/v1/locations/"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)
print(response.json())
const response = await fetch('https://admin.vps.org/api/v1/locations/', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  }
});

const locations = await response.json();
console.log(locations);
$ch = curl_init('https://admin.vps.org/api/v1/locations/');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_API_TOKEN',
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$locations = json_decode($response, true);
curl_close($ch);

Exempelsvar

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": 1,
      "name": "New Jersey",
      "country_name": "United States",
      "country_code": "US",
      "is_active": true
    }
  ]
}

Svarsfält

Fält Typ Varuslag
id integer Platsidentifikation. Använd den som plats_id när du skapar en server.
name string Platsnamn som kan läsas av människor
country_name string Land platsen är i
country_code string ISO 3166-1 alfa-2 landskod, stor bokstav
is_active boolean Om platsen accepterar nya servrar

Svarsstatuskoder

200 Platslistan har hämtats
403 Saknas eller ogiltig API- token, eller token saknar den behörighet som krävs
FÅ /api/v1/locations/{id}/

Skaffa en plats

Hämta en enda plats med sin id. Svaret är ett platsobjekt med fälten ovan.

curl -X GET "https://admin.vps.org/api/v1/locations/1/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{
  "id": 1,
  "name": "New Jersey",
  "country_name": "United States",
  "country_code": "US",
  "is_active": true
}

Var dina servrar kör

Varje VPS.org server körs för närvarande i vår New Jersey, USA plats, som betjänar kunder över hela världen över IPv4 och IPv6. Läs alltid platserna endpoint snarare än hårdkoda en id, så din integration plockar upp nya platser när de läggs till.