VPS API, 클라우드 서버를 JSON REST로 자동화

네, VPS API는 모든 회원에게 무료예요. API 키 발급과 요청은 무료이고, API로 만든 서버와 옵션은 제어판에서 만든 서버와 같은 요금으로 결제돼요. 첫 결제를 한 회원이면 API 키 페이지에서 바로 키를 만들 수 있어요.

첫 결제를 하면 API 키 페이지(/api-key)가 열리고, 여기서 키를 만들어요. 만든 키는 모든 요청의 Authorization 헤더에 Bearer 방식으로 넣어요. 키는 계정 전체를 다루는 열쇠이므로 코드 저장소에 그대로 올리지 말고 환경 변수나 비밀 값 저장소에 보관하세요.

판매 목록 읽기(GET /catalog), 서버 목록과 한 대 정보 읽기(GET /servers, GET /servers/{id}), 서버 만들기(POST /servers), 켜기와 끄기와 재시작(start, stop, reboot), 한 달 연장(renew), 삭제(DELETE /servers/{id})를 할 수 있어요. 요청 예시와 응답 형식은 API 문서에 있어요.

키 하나로 분당 300회까지 요청해요. 한도를 넘으면 429 상태 코드와 rate_limited 오류가 돌아오므로, 스크립트에서 잠시 기다렸다가 다시 보내도록 처리하면 돼요. 서버 목록 확인과 전원 관리 같은 일상적인 자동화는 이 한도 안에서 넉넉하게 동작해요. 요청 수에 따른 요금은 없어요.

POST /servers 요청이 성공하면 선택한 결제 기간의 요금이 결제되고 서버가 만들어져요. 만들기에 실패한 서버의 요금은 계정 크레딧으로 돌아와요.

서버 만들기 요청의 응답에 root_password 값이 한 번 담겨 와요. 응답을 받는 즉시 안전한 곳에 저장해 두세요. 제어판에서도 7일 동안 다시 볼 수 있고, SSH 키 번호를 함께 보내 두면 비밀번호 없이 키로 바로 접속해요. 응답의 ipv4 값으로 바로 SSH 접속을 시작할 수 있어 배포 스크립트와 잇기 좋아요.

네, 서버 만들기 요청에 ssh_key_id 값으로 등록해 둔 SSH 키 번호를 넣으면 새 서버에 그 키가 들어가요. 키 등록은 제어판의 SSH 키 화면에서 한 번 해 두면 되고, 지문은 ssh-keygen과 같은 방식으로 표시되어 어떤 키인지 바로 확인해요. 키 번호는 한 번 정해 두고 재사용해요.

HTTP 요청을 보낼 수 있다면 어떤 언어와 도구든 돼요. curl로 바로 시험하고, Python의 requests, Node.js의 fetch, GitLab CI의 스크립트 단계, Terraform의 HTTP 요청 기능에서 같은 주소와 헤더로 불러요. 응답은 모두 JSON이라 결과를 읽기 쉬워요.

오류는 2xx가 아닌 상태 코드와 함께 error 값이 담긴 JSON으로 돌아와요. 키가 틀리면 unauthorized, 값이 빠지면 bad_request, 잔액이 모자라면 not_enough_balance, 서버 상태와 맞지 않는 요청이면 wrong_state처럼 이유가 나뉘어 있어 프로그램에서 상황별로 처리해요.

네, API와 제어판은 같은 계정과 같은 서버를 다뤄요. API로 만든 서버는 제어판 목록에 그대로 보이고, 제어판에서 운영체제를 다시 설치하거나 비밀번호를 확인할 수 있어요. 계정당 서버 10대 한도도 두 방식에 함께 적용돼요. 손으로 하는 작업과 코드로 하는 작업을 섞어 써도 상태와 결제일이 항상 같게 보여요.