Delivery API

회원의 기본 배송지 조회 API입니다.

Base URL: /ai/delivery

인증 정보

항목	값
인증 필요	예
인증 방식	JWT Bearer Token

엔드포인트 목록

메서드	경로	설명	인증
`GET`	`/ai/delivery`	기본 배송지 조회	필요

API 상세

기본 배송지 조회

회원의 기본 배송지를 조회합니다.

HTTP 요청

GET /ai/delivery
Authorization: Bearer {access_token}

응답

성공 응답 (200 OK) - 배송지 있음

{
  "status": 200,
  "code": null,
  "message": "기본 배송지 조회 성공",
  "data": {
    "id": 1,
    "addressName": "집",
    "recipientName": "홍길동",
    "phone": "010-1234-5678",
    "zipCode": "12345",
    "address": "서울시 강남구 테헤란로 123",
    "addressDetail": "1층 101호",
    "isDefault": true
  }
}

성공 응답 (200 OK) - 배송지 없음

{
  "status": 200,
  "code": null,
  "message": "기본 배송지가 없습니다",
  "data": null
}

Response 스키마

필드명	타입	설명
`id`	`long`	배송지 ID
`addressName`	`string`	배송지 이름 (예: 집, 회사)
`recipientName`	`string`	받는 사람
`phone`	`string`	연락처
`zipCode`	`string`	우편번호
`address`	`string`	기본 주소
`addressDetail`	`string`	상세 주소
`isDefault`	`boolean`	기본 배송지 여부

사용 예시

curl -X GET https://api.glowb.io/ai/delivery \
  -H "Authorization: Bearer {token}"

배송지 캠페인 신청 매핑

기존 배송지 또는 새 배송지를 캠페인 신청에 매핑합니다.

addressId가 있으면: 기존 배송지를 캠페인 신청에 연결
addressId가 없으면: body의 배송지 정보로 새 배송지 추가 후 캠페인 신청에 연결

HTTP 요청

POST /ai/influence/delivery-address/application/{applicationId}?addressId={addressId}
Authorization: Bearer {access_token}
Content-Type: application/json

Path Parameters

파라미터	타입	필수	설명
`applicationId`	`long`	예	캠페인 신청 ID

Query Parameters

파라미터	타입	필수	설명
`addressId`	`long`	아니오	기존 배송지 ID. 있으면 기존 배송지 사용, 없으면 body로 새 배송지 추가

Request Body (새 배송지 추가 시)

addressId가 없을 때만 필요합니다.

{
  "addressName": "집",
  "recipientName": "홍길동",
  "recipientPhone": "01012345678",
  "postalCode": "12345",
  "baseAddress": "서울시 강남구 테헤란로 123",
  "detailAddress": "101호",
  "isDefault": true
}

응답

성공 응답 (200 OK)

{
  "status": 200,
  "code": null,
  "message": "배송지 매핑 완료",
  "data": {
    "id": 5,
    "addressName": "집",
    "recipientName": "홍길동",
    "phone": "01012345678",
    "zipCode": "12345",
    "address": "서울시 강남구 테헤란로 123",
    "addressDetail": "101호",
    "isDefault": true
  }
}

사용 예시

# 기존 배송지 매핑
curl -X POST "https://api.glowb.io/ai/influence/delivery-address/application/1234?addressId=5" \
  -H "Authorization: Bearer {token}"

# 새 배송지 추가 + 매핑
curl -X POST "https://api.glowb.io/ai/influence/delivery-address/application/1234" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{"addressName":"집","recipientName":"홍길동","recipientPhone":"01012345678","postalCode":"12345","baseAddress":"서울시 강남구 테헤란로 123","detailAddress":"101호","isDefault":true}'

hasDeliveryAddress / deliveryType 필드

GET /ai/influence/campaigns/applications (내 캠페인 신청 목록 조회) 응답의 각 신청 항목에 다음 필드가 포함됩니다.

hasDeliveryAddress

true: 해당 캠페인 신청에 배송지가 매핑되어 있음
false: 배송지 미등록 (배송지 매핑 API 호출 필요)

deliveryType — 캠페인의 배송 유형

DELIVERY: 배송
NO_DELIVERY: 배송 없음
VISIT_REQUIRED: 방문 필요
null: 미설정

deliveryType이 DELIVERY이고 hasDeliveryAddress가 false이면 크리에이터에게 배송지 등록을 안내해야 합니다.

Delivery API

Delivery API

인증 정보

엔드포인트 목록

API 상세

기본 배송지 조회

응답

Response 스키마

사용 예시

배송지 캠페인 신청 매핑

Path Parameters

Query Parameters

Request Body (새 배송지 추가 시)

응답

사용 예시

관련 API

API 테스트

On this page