빠른 시작

대시보드에서 API 키를 발급받은 뒤, 환경 변수에 저장하고 첫 요청을 보내보세요.

1. 환경 변수 설정

API 키는 서버 환경 변수에 저장합니다. Bank/PIN API 키와 Email API 키는 서로 다른 키이므로 각각 저장합니다.

BANK_API_KEY=ak_live_********
EMAIL_API_KEY=em_live_********

2. 첫 요청 보내기

Bank API로 충전 요청을 생성하는 예제입니다. 언어 탭을 눌러 원하는 언어의 예제를 확인하세요.

curl -X POST "https://bank.apiacc.com/request" \
  -H "Authorization: Bearer $BANK_API_KEY" \
  -H "Content-Type: application/json" \
  --max-time 10 \
  -d '{
    "amount": 10000,
    "depositor": "홍길동",
    "platform": "my-service",
    "ref": "order_1234"
  }'

코드 예제 공통 규칙

모든 예제는 API 키를 코드에 하드코딩하지 않고 환경 변수에서 읽어오며, 타임아웃과 상태 코드 확인 로직을 포함합니다.

3. 요청 체크리스트

Authorization 헤더 값은 반드시 Bearer 로 시작해야 합니다.
요청에 타임아웃을 설정해 응답이 지연될 때 무한 대기하지 않도록 합니다.
HTTP 상태 코드를 확인하고, 4xx/5xx 응답은 JSON 오류 본문을 읽어 처리합니다.
같은 요청을 재시도할 때는 요청 제한(rate limit) 문서를 참고하세요.

이전API 소개 다음인증