AQR API Reference

다양한 페이. SNS 링크. 간편 송금.
'하나의 QR과 URL에'

AQR 개발자를 위한 API 사용법과 예제코드를 제공합니다.

개발자 Token 발급 받기

API 사용을 위해 AQR 개발자 Token을 발급 받으세요.

AQR API는 AQR 개발자 Token을 파라미터로 입력해야 사용할 수 있습니다.

AQR 서비스의 "Advanced" 등급 또는 제휴사에 한해서 개발자 Token을 제공합니다.
개발자 Token은 아래의 AQR Square(페이지 관리 사이트)에 가입 및 로그인 후 화면의 우측 상단 "개인정보수정" 메뉴에서 확인 할 수 있습니다.

AQR Square 가기 →

계좌 정보 생성/삭제

계좌 정보 생성하기

기본 정보
POST https://aplx.link/api/
요청 파라미터
Header
파라미터명 설명 필수 타입 최대길이
AQR-DEVELOPER-TOKEN 부여받은 개발자 Token 값을 헤더에 입력합니다. Y String -
Body — application/x-www-form-urlencoded
파라미터명 설명 필수 타입 최대길이
action "create"를 입력합니다. Y String 20
email_address 가입시 입력한 이메일 주소를 입력합니다. Y String 100
account_number 계좌 번호를 입력합니다. Y String 30
bank_id 은행 ID를 입력합니다. (아래 은행 ID 테이블 참조) Y Integer -
account_owner 예금주 명을 입력합니다. Y String 50
phone_number 예금주의 전화번호를 입력합니다. Y String 20
account_name 생성할 계좌 정보의 이름을 입력합니다. Y String 100
요청 예시
curl -H "AQR-DEVELOPER-TOKEN: <DEVELOPER TOKEN>" \
     -H "Content-type: application/x-www-form-urlencoded" \
     -X POST \
     -d 'email_address=<EMAILID>&account_number=1234567894321&bank_id=1&account_owner=<OWNER NAME>&phone_number=01012341234&account_name=<ACCOUNT NAME>&action=create' \
     https://aplx.link/api/
$body['email_address'] = '<EMAILID>';
$body['account_number'] = '1234567894321';
$body['bank_id']        = '1';
$body['account_owner']  = '<OWNER NAME>';
$body['phone_number']   = '01012341234';
$body['account_name']   = '<ACCOUNT NAME>';
$body['action']         = 'create';

$headers = array(
    'Content-Type: application/x-www-form-urlencoded',
    'AQR-DEVELOPER-TOKEN: <DEVELOPER TOKEN>'
);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL,            'https://aplx.link/api/');
curl_setopt($ch, CURLOPT_HTTPHEADER,     $headers);
curl_setopt($ch, CURLOPT_POST,           true);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_POSTFIELDS,     http_build_query($body));
$response = curl_exec($ch);
curl_close($ch);

echo $response;
var formdata = new FormData();
formdata.append("email_address",  "<EMAILID>");
formdata.append("account_number", "123456789432");
formdata.append("bank_id",        "1");
formdata.append("account_owner",  "<OWNER NAME>");
formdata.append("phone_number",   "01012341234");
formdata.append("account_name",   "<ACCOUNT NAME>");
formdata.append("action",         "create");

$.ajax({
  url:         "https://aplx.link/api/",
  dataType:    "json",
  contentType: "application/x-www-form-urlencoded",
  crossDomain: true,
  cache:       false,
  data:        formdata,
  type:        "POST",
  async:       false,
  beforeSend:  function(request) {
    request.setRequestHeader("AQR-DEVELOPER-TOKEN", "<DEVELOPER TOKEN>");
  },
  success: function(r) {
    console.log(JSON.stringify(r));
    if (r.result == "success") {
      // r.data
    }
  },
  error: function(request, status, error) {
    alert("code:" + request.status + "\nmessage:" + request.responseText + "\nerror:" + error);
  }
});
import requests

headers = {
    'Content-Type':        'application/x-www-form-urlencoded',
    'AQR-DEVELOPER-TOKEN': '<DEVELOPER TOKEN>'
}
data = (
    "email_address=<EMAILID>"
    "&account_number=1234567894321"
    "&bank_id=1"
    "&account_owner=<OWNER NAME>"
    "&phone_number=01012341234"
    "&account_name=<ACCOUNT NAME>"
    "&action=create"
)
response = requests.post('https://aplx.link/api/', headers=headers, data=data)
response.raise_for_status()
print(response.json())
var content  = "email_address="   + Uri.EscapeDataString("<EMAILID>");
    content += "&account_number=" + Uri.EscapeDataString("1234567894321");
    content += "&bank_id="        + Uri.EscapeDataString("1");
    content += "&account_owner="  + Uri.EscapeDataString("<OWNER NAME>");
    content += "&phone_number="   + Uri.EscapeDataString("01012341234");
    content += "&account_name="   + Uri.EscapeDataString("<ACCOUNT NAME>");
    content += "&action="         + Uri.EscapeDataString("create");

var url = "https://aplx.link/api/";
byte[] data = Encoding.UTF8.GetBytes(content);
WebRequest request = WebRequest.Create(url);
request.Method        = "POST";
request.ContentType   = "application/x-www-form-urlencoded";
request.Headers.Add("AQR-DEVELOPER-TOKEN", "<DEVELOPER TOKEN>");
request.ContentLength = data.Length;

using (Stream stream = request.GetRequestStream())
{
    stream.Write(data, 0, data.Length);
}

try
{
    WebResponse response = await request.GetResponseAsync();
}
catch (WebException webException)
{
}
응답 파라미터
파라미터명 설명 타입
result 처리 결과 ("success" 또는 "error") String
reason 처리 결과가 "error"일 경우 오류 내용 String
data.qr_image QR 이미지 다운로드 경로 String
data.short_url 계좌 정보 고유 URL String
data.uniq_keyword 계좌 정보 ID — 삭제/수정 시 사용 String
응답 예시
JSON Response
{
  "result": "success",
  "data": {
    "qr_image":     "https://aplx.link/res?keyword=abcde",  // QR 이미지 다운로드 경로
    "short_url":    "https://aq.gy/f/abcde",                 // 계좌 정보 고유 URL
    "uniq_keyword": "abcde"                                   // 계좌 정보 ID (삭제/수정시 사용)
  }
}
은행 ID 테이블
ID은행명
0카카오뱅크
1토스뱅크
2케이뱅크
3국민은행
4기업은행
5농협은행
6신한은행
7부산은행
8우체국
9새마을금고
10산업은행
11우리은행
12하나은행
13한국시티은행
14SC제일은행
15경남은행
16광주은행
17대구은행
18도이치은행
19뱅크오브아메리카
20산림조합중앙회
21저축은행
22수협은행
23신협중앙회
24전북은행
25제주은행
26중국건설은행
27중국공상은행
28중국은행
29BNP파리바은행
ID기관명
30HSBC은행
31JP모간체이스은행
32DB금융투자
33메리츠증권
34부국증권
35교보증권
36대신증권
37현대차증권
38미레에셋증권
39삼성증권
40신영증권
41신한투자증권
42에스케이증권
43유안타증권
44유진투자증권
45이베스트투자증권
46케이프투자증권
47키움증권
48한국포스증권
49하나증권
50하이투자증권
51한국투자증권
52한화투자증권
53KB증권
54다올투자증권
55BNK투자증권
56NH투자증권
57토스증권
58카카오페이증권
59IBK투자증권

계좌 정보 삭제하기

기본 정보
POST https://aplx.link/api/
요청 파라미터
Header
파라미터명 설명 필수 타입 최대길이
AQR-DEVELOPER-TOKEN 부여받은 개발자 Token 값을 헤더에 입력합니다. Y String -
Body — application/x-www-form-urlencoded
파라미터명 설명 필수 타입 최대길이
action "delete"를 입력합니다. Y String 20
email_address 가입시 입력한 이메일 주소를 입력합니다. Y String 100
uniq_keyword 계좌 생성시 확인한 'uniq_keyword' 값을 입력합니다. Y String 20
요청 예시
curl -H "AQR-DEVELOPER-TOKEN: <DEVELOPER TOKEN>" \
     -H "Content-type: application/x-www-form-urlencoded" \
     -X POST \
     -d 'email_address=<EMAILID>&uniq_keyword=abcde&action=delete' \
     https://aplx.link/api/
$body['email_address'] = '<EMAILID>';
$body['uniq_keyword']  = 'abcde';
$body['action']        = 'delete';

$headers = array(
    'Content-Type: application/x-www-form-urlencoded',
    'AQR-DEVELOPER-TOKEN: <DEVELOPER TOKEN>'
);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL,            'https://aplx.link/api/');
curl_setopt($ch, CURLOPT_HTTPHEADER,     $headers);
curl_setopt($ch, CURLOPT_POST,           true);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_POSTFIELDS,     http_build_query($body));
$response = curl_exec($ch);
curl_close($ch);

echo $response;
var formdata = new FormData();
formdata.append("email_address", "<EMAILID>");
formdata.append("uniq_keyword",  "abcde");
formdata.append("action",        "delete");

$.ajax({
  url:         "https://aplx.link/api/",
  dataType:    "json",
  contentType: "application/x-www-form-urlencoded",
  crossDomain: true,
  cache:       false,
  data:        formdata,
  type:        "POST",
  async:       false,
  beforeSend:  function(request) {
    request.setRequestHeader("AQR-DEVELOPER-TOKEN", "<DEVELOPER TOKEN>");
  },
  success: function(r) {
    console.log(JSON.stringify(r));
    if (r.result == "success") {
      // success
    }
  },
  error: function(request, status, error) {
    alert("code:" + request.status + "\nmessage:" + request.responseText + "\nerror:" + error);
  }
});
import requests

headers = {
    'Content-Type':        'application/x-www-form-urlencoded',
    'AQR-DEVELOPER-TOKEN': '<DEVELOPER TOKEN>'
}
data = "email_address=<EMAILID>&uniq_keyword=abcde&action=delete"
response = requests.post('https://aplx.link/api/', headers=headers, data=data)
response.raise_for_status()
print(response.json())
var content  = "email_address=" + Uri.EscapeDataString("<EMAILID>");
    content += "&uniq_keyword="  + Uri.EscapeDataString("abcde");
    content += "&action="        + Uri.EscapeDataString("delete");

var url = "https://aplx.link/api/";
byte[] data = Encoding.UTF8.GetBytes(content);
WebRequest request = WebRequest.Create(url);
request.Method        = "POST";
request.ContentType   = "application/x-www-form-urlencoded";
request.Headers.Add("AQR-DEVELOPER-TOKEN", "<DEVELOPER TOKEN>");
request.ContentLength = data.Length;

using (Stream stream = request.GetRequestStream())
{
    stream.Write(data, 0, data.Length);
}

try
{
    WebResponse response = await request.GetResponseAsync();
}
catch (WebException webException)
{
}
응답 파라미터
파라미터명 설명 타입
result 처리 결과 ("success" 또는 "error") String
reason 처리 결과가 "error"일 경우 오류 내용 String
응답 예시
JSON Response
{
  "result": "success"
}

Errors

AQR API에서 사용하는 HTTP 에러 코드입니다.

Error Code 설명
400Bad Request — 요청이 잘못되었습니다.
401Unauthorized — API 키가 잘못되었습니다.
403Forbidden — 관리자 전용 API입니다.
404Not Found — 요청한 리소스를 찾을 수 없습니다.
405Method Not Allowed — 잘못된 HTTP 메서드를 사용하였습니다.
406Not Acceptable — JSON 형식이 아닌 포맷을 요청하였습니다.
410Gone — 요청한 리소스가 서버에서 삭제되었습니다.
429Too Many Requests — 요청 횟수가 너무 많습니다. 잠시 후 다시 시도하세요.
500Internal Server Error — 서버 오류가 발생하였습니다. 잠시 후 다시 시도하세요.
503Service Unavailable — 서비스 점검 중입니다. 잠시 후 다시 시도하세요.