VPS.org API

REST API Documentation

Lokations-API

Angiv de steder, hvor du kan implementere en VPS. Pass en placerings id som location_id, når du opretter en server.

Endepunkter 2 endpoints
Basissti /api/v1/locations
/api/v1/locations/

Liste over alle placeringer

Hent en liste over alle tilgængelige datacenter steder, hvor du kan implementere VPS-servere.

Eksempel på anmodning

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);

Eksempel på svar

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

Svarfelter

Felt Type Description
id integer Sted- id. Brug det som location_id, når du opretter en server.
name string Navn på det menneskelige læsbare sted
country_name string Land, hvor
country_code string ISO 3166-1 alfa-2-landekode, store bogstaver
is_active boolean Om placeringen accepterer nye servere

Svarstatuskoder

200 Liste over lokationer er hentet
403 Manglende eller ugyldig API token, eller den token mangler den krævede tilladelse
/api/v1/locations/{id}/

Få et sted

Hent et enkelt sted ved dets id. Svaren er et sted objekt med felterne ovenfor.

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
}

Hvor dine tjenere løber hen

Hver VPS.org server kører i øjeblikket i vores New Jersey, USA placering, som tjener kunder over hele verden over IPv4 og IPv6. Altid læse placeringer endpoint snarere end hardcoding en id, så din integration opfanger nye steder, når de er tilføjet.