API 개발가이드

시작하기

API를 찾고, 요청하고, 응답을 확인하는 가장 짧은 경로.

첫 요청으로 이동 ↓

시작 전 준비

첫 API 연결

인증키 하나로, 첫 응답까지.

서버에 인증키를 준비하고 계정 정보를 조회해 연결을 확인하세요. 언어를 선택해 예제를 복사하면 됩니다.

내 인증키 확인하기
서버 환경변수 APICK_API_KEY에 저장
아래 요청을 실행하고 응답 확인

인증키를 브라우저·모바일 앱·공개 저장소에 넣지 마세요. 이 문서의 예제는 자동 실행되지 않습니다.

첫 요청 보내기

API 요청 예제직접 실행하지 않습니다POST /rest/info

POSIX 셸 · APICK_API_KEY 환경변수를 먼저 설정하세요. Windows에서는 Unicode 지원 cURL을 사용하세요.

printf '%s\r\n' '--apick-empty--' | curl --fail-with-body --request POST 'https://apick.app/rest/info' \
  --header "Authorization: Bearer $APICK_API_KEY" \
  --header 'Content-Type: multipart/form-data; boundary=apick-empty' \
  --data-binary @-

Node.js 22+ · 서버에서 실행하는 ESM 예제입니다. 키를 브라우저에 넣지 마세요.

const form = new FormData();
const response = await fetch("https://apick.app/rest/info", {
  method: "POST",
  headers: { Authorization: "Bearer " + process.env.APICK_API_KEY },
  body: form,
  signal: AbortSignal.timeout(120_000),
});
if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`);
const result = await response.json();
console.log(result);

Python 3 · requests 설치가 필요합니다. 키는 서버 환경변수로 읽습니다.

import os
import requests
response = requests.request("POST", "https://apick.app/rest/info",
    headers={"Authorization": "Bearer " + os.environ["APICK_API_KEY"], "Content-Type": "multipart/form-data; boundary=apick-empty"},
    data=b"--apick-empty--\r\n",
    timeout=(10, 120))
response.raise_for_status()
result = response.json()
print(result)

PHP 8 · cURL 확장이 필요합니다. 키는 서버 환경변수로 읽습니다.

<?php
$headers = ["Authorization: Bearer " . getenv("APICK_API_KEY")];
$headers[] = "Content-Type: multipart/form-data; boundary=apick-empty";
$form = "--apick-empty--\r\n";
$curl = curl_init('https://apick.app/rest/info');
curl_setopt_array($curl, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => $headers,
    CURLOPT_POSTFIELDS => $form,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CONNECTTIMEOUT => 10, CURLOPT_TIMEOUT => 120,
]);
$body = curl_exec($curl);
if ($body === false) { throw new RuntimeException(curl_error($curl)); }
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
if ($status >= 400) { throw new RuntimeException($body); }
$result = json_decode($body, true, 512, JSON_THROW_ON_ERROR);
print_r($result);

POSIX 셸 · APICK_API_KEY 환경변수를 먼저 설정하세요. Windows에서는 Unicode 지원 cURL을 사용하세요.

printf '%s\r\n' '--apick-empty--' | curl --fail-with-body --request POST 'https://apick.app/rest/info' \
  --header "Authorization: Bearer $APICK_API_KEY" \
  --connect-timeout 10 --max-time 120 \
  --header 'Content-Type: multipart/form-data; boundary=apick-empty' \
  --data-binary @-

Node.js 22+ · 서버에서 실행하는 ESM 예제입니다. 키를 브라우저에 넣지 마세요.

const form = new FormData();
const response = await fetch("https://apick.app/rest/info", {
  method: "POST",
  headers: { Authorization: "Bearer " + process.env.APICK_API_KEY },
  body: form,
  signal: AbortSignal.timeout(120_000),
});
if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`);
const result = await response.json();
if (result.error || result.data?.error || result.result?.error || result.success === false || result.api?.success === false) {
  throw new Error(JSON.stringify(result));
}
console.log(result);

Python 3 · requests 설치가 필요합니다. 키는 서버 환경변수로 읽습니다.

import os
import requests
response = requests.request("POST", "https://apick.app/rest/info",
    headers={"Authorization": "Bearer " + os.environ["APICK_API_KEY"], "Content-Type": "multipart/form-data; boundary=apick-empty"},
    data=b"--apick-empty--\r\n",
    timeout=(10, 120))
response.raise_for_status()
result = response.json()
if result.get("error") or (isinstance(result.get("data"), dict) and result["data"].get("error")) or (isinstance(result.get("result"), dict) and result["result"].get("error")) or result.get("success") is False or (result.get("api") or {}).get("success") is False:
    raise RuntimeError(result)
print(result)

PHP 8 · cURL 확장이 필요합니다. 키는 서버 환경변수로 읽습니다.

<?php
$headers = ["Authorization: Bearer " . getenv("APICK_API_KEY")];
$headers[] = "Content-Type: multipart/form-data; boundary=apick-empty";
$form = "--apick-empty--\r\n";
$curl = curl_init('https://apick.app/rest/info');
curl_setopt_array($curl, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => $headers,
    CURLOPT_POSTFIELDS => $form,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CONNECTTIMEOUT => 10, CURLOPT_TIMEOUT => 120,
]);
$body = curl_exec($curl);
if ($body === false) { throw new RuntimeException(curl_error($curl)); }
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
if ($status >= 400) { throw new RuntimeException($body); }
$result = json_decode($body, true, 512, JSON_THROW_ON_ERROR);
if (!empty($result["error"]) || !empty($result["data"]["error"]) || !empty($result["result"]["error"]) || ($result["success"] ?? true) === false || ($result["api"]["success"] ?? true) === false) {
    throw new RuntimeException($body);
}
print_r($result);

계정 정보로 연결 확인

POST/rest/info

공통 주소 https://apick.app에 요청합니다. 추가 폼 항목 없이 Bearer 키로 계정 정보를 조회합니다.

헤더

값

Authorization

Bearer $APICK_API_KEY

응답에 개인정보·계정 정보가 포함될 수 있으므로 서버 로그에 전체 응답을 남기지 마세요.

계정 정보 응답 명세 보기 →

응답을 읽는 순서

HTTP 상태: 전송·인증·입력 오류 확인
api.success: API 처리 여부 확인
data: 서비스별 업무 결과 확인
api.cost: 이번 요청의 과금 확인

응답 형식은 서비스에 따라 JSON 또는 파일이며, 지원하는 AI 서비스에서는 스트리밍도 사용할 수 있습니다.

정적 응답 예시 보기 · 실제 조회 아님

{
  "data": {
    "email": "developer@example.com",
    "email_auth": 1,
    "point": 0,
    "last_login": "2026-01-01T09:00:00+09:00",
    "allow_ip": "",
    "is_active": true,
    "success": 1
  },
  "api": {
    "success": true,
    "cost": 0,
    "ms": 10,
    "pl_id": 0
  }
}

요청·인증 규칙

본문이 있는 REST 요청은 multipart/form-data입니다. 객체와 배열은 messages[0][role], messages[0][content]처럼 각 값을 별도 항목으로 보냅니다. Content-Type의 boundary는 사용 중인 라이브러리가 설정합니다.

본문 없는 GET과 MCP의 JSON-RPC 규격은 그대로 사용합니다. 기존 JSON·폼 요청은 호환용으로 유지됩니다.

API 인증은 서버의 Bearer 키, 사용자 간편인증은 해당 자료의 본인 확인 절차입니다. 두 인증을 구분하세요.

필요한 API 찾기

진위확인텍스트 입력으로 신분증 진위 확인 간편인증 자료 조회인증 요청부터 결과 수신까지 AI 연동대화 요청과 스트리밍 응답 파일 변환폼 입력으로 엑셀 파일 받기

요금·공통 정책

서비스별 단가·필수 입력·과금 조건을 먼저 확인하세요. 자료 조회형은 인증 요청과 결과 제공 시점의 비용이 분리됩니다.

서비스별 요금·공통 주소·상세 정책

요청 본문은 multipart/form-data로 전송합니다. 응답은 서비스에 따라 JSON 또는 파일이며, AI 대화는 SSE 응답도 지원합니다. 첨부 파일과 생성 결과의 보관·다운로드 조건은 서비스마다 다릅니다. 각 문서의 결과 보관 기간과 재다운로드 조건을 확인하세요. 에이픽 API 서비스 중 일부는 최초 1회 이상 결제시 사용 가능합니다. 해당 목록은 아래 표를 통해 확인할 수 있습니다.

최소 1회 이상 결제시 사용 가능한 API 목록(무료 포인트로 사용 불가능)

API 기능

호출 URL

1원 인증

/rest/transfer_1won

계좌 예금주 실명 조회

/rest/account_realname

외국인등록증 개인정보 마스킹

/rest/identity_document_residence_card

여권 개인정보 마스킹

/rest/identity_document_passport

주민등록증 개인정보 마스킹

/rest/identity_document_id_card

운전면허증 개인정보 마스킹

/rest/identity_document_driver_license

이미지 텍스트 추출(OCR)

/rest/ocr

주민등록증 텍스트 추출(OCR)

/rest/ocr_identi1

운전면허증 텍스트 추출(OCR)

/rest/ocr_identi2

여권 텍스트 추출(OCR)

/rest/ocr_identi3

주민등록등본 텍스트 추출(OCR)

/rest/ocr_identi4

외국인등록증 텍스트 추출(OCR)

/rest/ocr_identi5

CUSTOM_OCR_1

/rest/ocr_identi_custom_1

부동산 실거래가 조회

/rest/land_rt_price

개인통관고유부호 인증 요청

/rest/req_pccc

개인통관고유부호 조회

/rest/get_pccc

LLM 채팅 API 레퍼런스

/rest/llm/chat

텍스트 요약 AI

/rest/llm/text_summary

텍스트 다듬기 AI

/rest/llm/text_polish

한국어 AI 내레이션 TTS

/rest/tts/jobs

에이픽 이미지 AI

/rest/image-generation/generate

Seedance 영상 생성 AI

/rest/seedance/jobs

Veo 영상 생성 AI

/rest/veo/jobs

Kling 영상 생성 AI

/rest/kling/jobs

재직·보험료 확인 조회 인증 요청

/rest/req_employment

재직·보험료 확인 결과조회

/rest/get_employment

금융소득(이자·배당) 조회 인증 요청

/rest/req_personal_income

금융소득(이자·배당) 결과조회

/rest/get_personal_income

현금영수증 소득공제 내역 조회 인증 요청

/rest/req_cash_receipt_deduction

현금영수증 소득공제 내역 결과조회

/rest/get_cash_receipt_deduction

일용·간이·용역 소득내역 조회 인증 요청

/rest/req_income_by_payer

일용·간이·용역 소득내역 결과조회

/rest/get_income_by_payer

소득자료 확인 조회 인증 요청

/rest/req_income_data_check

소득자료 확인 결과조회

/rest/get_income_data_check

국민연금 가입내역 조회 인증 요청

/rest/req_nps_join_history

국민연금 가입내역 결과조회

/rest/get_nps_join_history

국세 신고내역 조회 인증 요청

/rest/req_tax_return_history

국세 신고내역 결과조회

/rest/get_tax_return_history

국세 납부·환급·체납 조회 인증 요청

/rest/req_tax_payment_history

국세 납부·환급·체납 결과조회

/rest/get_tax_payment_history

지방세 납부·환급 조회 인증 요청

/rest/req_local_tax_payment

지방세 납부·환급 결과조회

/rest/get_local_tax_payment

운전면허 조회 인증 요청

/rest/req_driving_license

운전면허 결과조회

/rest/get_driving_license

국가 건강검진 결과 조회 인증 요청

/rest/req_health_checkup

국가 건강검진 결과 결과조회

/rest/get_health_checkup

기납 과태료·범칙금 조회 인증 요청

/rest/req_police_penalty

기납 과태료·범칙금 결과조회

/rest/get_police_penalty

주택담보대출 조회 인증 요청

/rest/req_mortgage_loan

주택담보대출 결과조회

/rest/get_mortgage_loan

주택자금대출 보증료 미환급금 조회 인증 요청

/rest/req_housing_refund_balance

주택자금대출 보증료 미환급금 결과조회

/rest/get_housing_refund_balance

주택연금 보증잔액 조회 인증 요청

/rest/req_housing_pension_balance

주택연금 보증잔액 결과조회

/rest/get_housing_pension_balance

주택금융 대출진행단계 조회 인증 요청

/rest/req_housing_loan_stage

주택금융 대출진행단계 결과조회

/rest/get_housing_loan_stage

모기지론 신청결과 조회 인증 요청

/rest/req_mortgage_application

모기지론 신청결과 결과조회

/rest/get_mortgage_application

주정차 과태료 납부 대상 확인 조회 인증 요청

/rest/req_parking_fine_target

주정차 과태료 납부 대상 확인 결과조회

/rest/get_parking_fine_target

한국산업인력공단 확인서 진위확인 조회 인증 요청

/rest/req_confirm_verify

한국산업인력공단 확인서 진위확인 결과조회

/rest/get_confirm_verify

전기요금 납부내역 조회 인증 요청

/rest/req_power_bill

전기요금 납부내역 결과조회

/rest/get_power_bill

차량 통합이력 조회 인증 요청

/rest/req_vehicle_history

차량 통합이력 결과조회

/rest/get_vehicle_history

소득 통합 조회 인증 요청

/rest/req_income_bundle

소득 통합 결과조회

/rest/get_income_bundle

국세 신고·납부 통합 조회 인증 요청

/rest/req_tax_bundle

국세 신고·납부 통합 결과조회

/rest/get_tax_bundle

주택금융 통합 조회 인증 요청

/rest/req_housing_bundle

주택금융 통합 결과조회

/rest/get_housing_bundle

운전·차량 행정 통합 조회 인증 요청

/rest/req_license_bundle

운전·차량 행정 통합 결과조회

/rest/get_license_bundle

차량 사고·채무 이력 조회 인증 요청

/rest/req_vehicle_risk

차량 사고·채무 이력 결과조회

/rest/get_vehicle_risk

차량 기본 확인 통합 조회 인증 요청

/rest/req_vehicle_basic

차량 기본 확인 통합 결과조회

/rest/get_vehicle_basic

차량 정비·성능 이력 조회 인증 요청

/rest/req_vehicle_condition

차량 정비·성능 이력 결과조회

/rest/get_vehicle_condition

차량 매물 확인 통합 조회 인증 요청

/rest/req_vehicle_trade

차량 매물 확인 통합 결과조회

/rest/get_vehicle_trade

자동차 등록정보 조회 인증 요청

/rest/req_vehicle_registration

자동차 등록정보 결과조회

/rest/get_vehicle_registration

자동차 검사이력 조회 인증 요청

/rest/req_vehicle_inspection

자동차 검사이력 결과조회

/rest/get_vehicle_inspection

자동차 정비이력 조회 인증 요청

/rest/req_vehicle_repair

자동차 정비이력 결과조회

/rest/get_vehicle_repair

중고차 성능점검이력 조회 인증 요청

/rest/req_vehicle_performance

중고차 성능점검이력 결과조회

/rest/get_vehicle_performance

의무보험 가입정보 조회 인증 요청

/rest/req_vehicle_insurance

의무보험 가입정보 결과조회

/rest/get_vehicle_insurance

자동차세 체납이력 조회 인증 요청

/rest/req_vehicle_tax_delinquency

자동차세 체납이력 결과조회

/rest/get_vehicle_tax_delinquency

압류 등록이력 조회 인증 요청

/rest/req_vehicle_seizure

압류 등록이력 결과조회

/rest/get_vehicle_seizure

저당권 등록이력 조회 인증 요청

/rest/req_vehicle_mortgage

저당권 등록이력 결과조회

/rest/get_vehicle_mortgage

폐차 정보 조회 인증 요청

/rest/req_vehicle_scrap

폐차 정보 결과조회

/rest/get_vehicle_scrap

주행거리 이력 조회 인증 요청

/rest/req_vehicle_mileage

주행거리 이력 결과조회

/rest/get_vehicle_mileage

튜닝 이력 조회 인증 요청

/rest/req_vehicle_tuning

튜닝 이력 결과조회

/rest/get_vehicle_tuning

전손 처리정보 조회 인증 요청

/rest/req_vehicle_total_loss

전손 처리정보 결과조회

/rest/get_vehicle_total_loss

타인차량 이력요약 조회 인증 요청

/rest/req_vehicle_third_party

타인차량 이력요약 결과조회

/rest/get_vehicle_third_party

자동차 평균매매가 조회 인증 요청

/rest/req_vehicle_market_price

자동차 평균매매가 결과조회

/rest/get_vehicle_market_price

재직·보험료 확인

/rest/req_employment

금융소득(이자·배당) 조회

/rest/req_personal_income

현금영수증 소득공제 내역

/rest/req_cash_receipt_deduction

일용·간이·용역 소득내역

/rest/req_income_by_payer

소득자료 확인

/rest/req_income_data_check

국민연금 가입내역조회

/rest/req_nps_join_history

국세 신고내역조회

/rest/req_tax_return_history

국세 납부·환급·체납조회

/rest/req_tax_payment_history

지방세 납부·환급조회

/rest/req_local_tax_payment

운전면허 조회

/rest/req_driving_license

국가 건강검진 결과 조회

/rest/req_health_checkup

기납 과태료·범칙금 조회

/rest/req_police_penalty

주택담보대출 조회

/rest/req_mortgage_loan

주택자금대출 보증료 미환급금 조회

/rest/req_housing_refund_balance

주택연금 보증잔액 조회

/rest/req_housing_pension_balance

주택금융 대출진행단계 조회

/rest/req_housing_loan_stage

모기지론 신청결과 조회

/rest/req_mortgage_application

주정차 과태료 납부 대상 확인

/rest/req_parking_fine_target

한국산업인력공단 확인서 진위확인

/rest/req_confirm_verify

전기요금 납부내역 조회

/rest/req_power_bill

차량 통합이력조회

/rest/req_vehicle_history

소득 통합조회

/rest/req_income_bundle

국세 신고·납부 통합조회

/rest/req_tax_bundle

주택금융 통합조회

/rest/req_housing_bundle

운전·차량 행정 통합조회

/rest/req_license_bundle

차량 사고·채무 이력조회

/rest/req_vehicle_risk

차량 기본 확인 통합조회

/rest/req_vehicle_basic

차량 정비·성능 이력조회

/rest/req_vehicle_condition

차량 매물 확인 통합조회

/rest/req_vehicle_trade

자동차 등록정보 조회

/rest/req_vehicle_registration

자동차 검사이력 조회

/rest/req_vehicle_inspection

자동차 정비이력 조회

/rest/req_vehicle_repair

중고차 성능점검이력 조회

/rest/req_vehicle_performance

의무보험 가입정보 조회

/rest/req_vehicle_insurance

자동차세 체납이력 조회

/rest/req_vehicle_tax_delinquency

압류 등록이력 조회

/rest/req_vehicle_seizure

저당권 등록이력 조회

/rest/req_vehicle_mortgage

폐차 정보 조회

/rest/req_vehicle_scrap

주행거리 이력 조회

/rest/req_vehicle_mileage

튜닝 이력 조회

/rest/req_vehicle_tuning

전손 처리정보 조회

/rest/req_vehicle_total_loss

타인차량 이력요약 조회

/rest/req_vehicle_third_party

자동차 평균매매가 조회

/rest/req_vehicle_market_price

공통 API 주소

URL

https://apick.app/rest/

공통 인증 방식

Header

이름

필수

설명

Authorization

Bearer 인증키

시작하기

시작 전 준비

인증키 하나로, 첫 응답까지.

첫 요청 보내기

계정 정보로 연결 확인

응답을 읽는 순서

요청·인증 규칙

필요한 API 찾기

요금·공통 정책

최소 1회 이상 결제시 사용 가능한 API 목록(무료 포인트로 사용 불가능)

공통 API 주소

공통 인증 방식

Header

개발가이드 검색

AI•LLM

전체상품

API 체험하기

요금정책

고객지원

개발가이드