VPS.org API 문서

시작하기

VPS.org API를 사용하면 서버, 도메인, DNS 레코드, 백업 및 스냅샷을 포함한 VPS 호스팅 인프라의 모든 측면을 프로그래밍 방식으로 관리할 수 있습니다.

입증

모든 API 요청에는 베어러 토큰을 사용한 인증이 필요합니다. 계정 설정에서 API 토큰을 생성할 수 있습니다. admin.vps.org/account/developers/.

cURL

Python

JavaScript

curl -X GET https://admin.vps.org/api/v1/servers/ \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

import requests

url = "https://admin.vps.org/api/v1/servers/"
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/servers/', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  }
});

const data = await response.json();
console.log(data);

속도 제한

API 요청은 API 토큰당 5분 동안 300회로 제한됩니다. 요청 제한 정보는 응답 헤더에 포함되어 있습니다.

X-RateLimit-Limit: 허용되는 최대 요청 수
X-RateLimit-Remaining: 남은 요청 수
X-RateLimit-Reset: 속도 제한이 재설정되는 시점의 타임스탬프

오류 처리

API는 표준 HTTP 상태 코드를 사용하여 성공 또는 실패를 나타냅니다.

상태 코드	설명
`200`	성공 - 요청이 성공적으로 완료되었습니다.
`201`	생성됨 - 리소스가 성공적으로 생성되었습니다
`400`	잘못된 요청 - 유효하지 않은 매개변수 또는 잘못된 형식의 요청입니다.
`401`	권한 없음 - 인증 토큰이 유효하지 않거나 누락되었습니다.
`403`	접근 금지 - 권한 부족
`404`	찾을 수 없음 - 리소스가 존재하지 않습니다.
`429`	요청이 너무 많습니다 - 속도 제한 초과
`500`	내부 서버 오류 - 저희 시스템에 문제가 발생했습니다.