간편인증 조회 API
사용자 승인 한 번으로 공공·금융 자료를 받으세요.

연동 예제

인증키는 Authorization: Bearer 헤더로 보냅니다. 서버에서만 호출하고 인증키를 브라우저·앱에 넣지 마세요.

curl -X POST "https://apick.app/rest/req_health_checkup" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --form-string "name=홍길동" \
  --form-string "birthDate=19900101" \
  --form-string "phone=01011112222" \
  --form-string "authProvider=kakao"

const form = new FormData();
form.append("name", "홍길동");
form.append("birthDate", "19900101");
form.append("phone", "01011112222");
form.append("authProvider", "kakao");

const response = await fetch("https://apick.app/rest/req_health_checkup", {
  method: "POST",
  headers: { Authorization: "Bearer " + process.env.APICK_API_KEY },
  body: form,
});
const { data, api } = await response.json();
if (data.error) throw new Error(data.error); // 실패는 과금되지 않습니다
console.log(data, api.cost);

응답 예시

{
  "data": {
    "schemaVersion": "1.0",
    "transactionId": "9f2c4a7b1d8e35c60a4f7b2d1e9c803a",
    "product": "health_checkup",
    "status": "AUTH_REQUESTED",
    "resultAvailable": false,
    "charged": true,
    "sources": [],
    "message": "인증 대기중입니다.",
    "expiresAt": "2026-09-20T05:24:07+09:00",
    "success": 1
  },
  "api": {
    "success": true,
    "cost": 20,
    "ms": 1284
  }
}

인증 요청 응답 예시입니다. 사용자가 승인한 뒤 같은 transactionId로 결과 조회 API(/rest/get_*)를 호출하면 표준 JSON 결과를 받습니다.

오류 해결

HTTP 상태 → api.success → data.error → api.cost 순서로 확인하세요. 실패 응답은 과금되지 않습니다.

• AUTH_REJECTED · AUTH_EXPIREDHTTP 200

  사용자가 승인을 거절했거나 5분 안에 승인하지 않았습니다. 자동으로 다시 요청하지 말고 사용자에게 안내하세요.

• AUTH_WAITING · COLLECTINGHTTP 200

  아직 결과가 없습니다. 간격을 두고 같은 transactionId로 결과를 조회하세요. 과금되지 않습니다.

• 무료 포인트로 사용할 수 없는 서비스입니다.HTTP 200

  최소 1회 충전(결제) 후 이용할 수 있는 API입니다. 충전 후 같은 요청을 다시 보내세요.

• 유효하지 않은 API키 입니다.HTTP 401

  Authorization: Bearer 헤더의 인증키를 확인하세요. 인증키는 마이페이지에서 확인합니다.

• 허용되지 않은 IP주소 입니다.HTTP 401

  마이페이지의 허용 IP 설정과 요청을 보내는 서버 IP를 확인하세요.

• 사용 가능한 포인트이 부족합니다.HTTP 200

  HTTP 200이어도 data.error가 있으면 실패입니다. 포인트를 충전한 뒤 다시 요청하세요. 이 응답은 과금되지 않습니다.

전체 응답 항목과 오류 코드는 개발 문서에 있습니다.