UNLOCK API
API 키 받기
API 키와 보안
MarkdownOpenAPI

API 키와 보안

키를 보내는 방법, 키 여러 개 쓰기, 내 서버만 허용하기.

내 키

모든 요청에 계정 화면의 API 키를 담아요. JSON 요청은 clientKey, in.php와 res.php는 key예요. 키는 32자(0-9, a-f)예요. 키는 서버에만 두세요. 키를 가진 사람은 누구나 내 잔액을 쓸 수 있어요.
POST /getBalance
{
  "clientKey": "YOUR_API_KEY"
}

추가 키

계정 화면에서 추가 키를 5개까지 만들 수 있어요. 예를 들어 서버나 프로젝트마다 하나씩요. 잔액은 함께 쓰고, 마지막 사용 시각이 보이고, 하나씩 끌 수 있어요.

IP 허용 목록

계정 화면에서 IP 주소를 20개까지 넣으면 그 주소만 내 키를 쓸 수 있어요. 다른 주소에서 온 요청은 ERROR_IP_NOT_ALLOWED를 받고 비용이 빠지지 않아요.
오류
{
  "errorId": 1,
  "errorCode": "ERROR_IP_NOT_ALLOWED",
  "errorDescription": "Requests from this IP are not allowed. Add it to the IP allow list on your account page."
}

브라우저에서 호출

header_acao=1을 보내면 in.php와 res.php가 CORS 헤더 Access-Control-Allow-Origin: *를 붙여요. 공개 웹 페이지에서 API를 부르면 키가 드러나니, 내 도구에서만 쓰세요.