OpenAPI Specification
openapi: 3.2.0
info:
title: Barogo Gorela Order Agency Delivery API
version: '2026-06-23'
summary: 고릴라(Gorela) 배달대행 중계 플랫폼 — 주문 제휴사(Order Agency) 연동 API
description: 'Gorela is the delivery-brokerage platform operated by Barogo (바로고). It sits between an order agency (a POS, marketplace or commerce platform that takes the customer''s order) and the delivery agencies that dispatch riders. One order can fan out to N deliveries.
This OpenAPI document was DERIVED by API Evangelist from Barogo''s own published developer reference at https://developer.gorelas.com/api-docs-md/ (last updated 2026-06-23). Every path, method, parameter name, type, enum value and example is carried over verbatim from those documents. Barogo does not publish an OpenAPI document of its own; this is a faithful transcription, not a provider-published artifact.
Auth: `Authorization: Bearer {API_Key}` — API keys are issued from the 연동 관리 (linkage) console at https://developer.gorelas.com/linkage after partner registration.'
contact:
name: Gorela TAM
email: tech_poc@barogo.com
url: https://developer.gorelas.com/
x-origin:
- format: markdown
url: https://developer.gorelas.com/api-docs-md/index.md
version: '2026-06-23'
converter:
url: https://apievangelist.com
version: pipeline-enrich local-v1
servers:
- url: https://api-interlocker.gorelas.com
description: 운영 (production)
- url: https://staging-api-interlocker.gorelas.com
description: 테스트 (staging)
security:
- bearerAuth: []
tags:
- name: Delivery
description: 배달대행사 배달 수행 상태 조회
paths:
/api/delivery-conditions:
get:
operationId: getDeliveryAgencyConditions
summary: 배달대행사 상태 조회
description: '공식 문서: 배달대행사 상태 조회'
tags:
- Delivery
x-evidence:
method: derived-from-published-docs
sources:
- https://developer.gorelas.com/api-docs-md/request-10.md
fetched: '2026-08-06'
parameters:
- name: orderAgencyId
in: query
required: true
description: 주문 제휴사 아이디
schema:
type: string
maxLength: 30
description: 주문 제휴사 아이디
- name: orderAgencyStoreId
in: query
required: true
description: 주문 제휴사의 상점 아이디
schema:
type: string
maxLength: 100
description: 주문 제휴사의 상점 아이디
responses:
'200':
description: 요청한 작업이 성공했을 때 응답됩니다.
content:
application/json:
schema:
oneOf:
- type: object
properties:
statusCode:
type: integer
data:
type: array
items:
type: object
properties:
deliveryAgencyId:
type: string
maxLength: 30
description: 배달대행사 아이디
deliveryAgencyName:
type: string
maxLength: 30
description: 배달대행사 이름
isDeliveryPossible:
type: boolean
description: 배달 가능 여부 *[배달 중단/해제](/api-doc/callback#배달_중단_/_해제) 콜백에 의해 변경(반영)되는 값입니다.*
delayTime:
type: integer
description: 배달 지연 시간 (분)
totalExtraCharge:
type: integer
description: 총 할증 금액
extraCharges:
type: array
items:
type: object
properties:
dataType:
type: string
description: 할증 데이터 종류
enum:
- FIXED
- RATE
- NONE
x-enum-descriptions:
FIXED: 정액 타입 할증(원)
RATE: 정률 타입 할증(%)
NONE: 금액을 특정할 수 없는 타입의 할증
type:
type: string
description: 할증 종류
enum:
- WEATHER
- AREA
- HOLIDAY
- TIME
- BUSY
- LATE_NIGHT
- VALUABLE
- ETC
x-enum-descriptions:
WEATHER: 기상
AREA: 구역
HOLIDAY: 휴일
TIME: 시간)
BUSY: 배달 폭증
LATE_NIGHT: 심야
VALUABLE: 귀중
ETC: 기타
charge:
type: integer
description: 할증 금액 또는 할증률 할증 목록
required:
- dataType
- type
- charge
title: 할증 데이터
pickupMinimumAt:
type: integer
description: 픽업 최소 일시 (timestamp)
required:
- deliveryAgencyId
- deliveryAgencyName
- isDeliveryPossible
- delayTime
- totalExtraCharge
- pickupMinimumAt
title: 성공 응답 데이터
required:
- statusCode
- data
title: Response Data (SUCCESS)
- type: object
properties:
statusCode:
type: integer
data:
type: array
items:
type: object
properties:
deliveryAgencyId:
type: string
maxLength: 30
description: 배달대행사 아이디
deliveryAgencyName:
type: string
maxLength: 30
description: 배달대행사 이름
isDeliveryPossible:
type: boolean
description: 배달 가능 여부 *[배달 중단/해제](/api-doc/callback#배달_중단_/_해제) 콜백에 의해 변경(반영)되는 값입니다.*
reason:
type: string
description: 배달 불가능 상태 유형
enum:
- OVER_CAPACITY
- BAD_WEATHER
- CLOSE_AGENCY
- CLOSE_STORE
- ETC
x-enum-descriptions:
OVER_CAPACITY: 배달을 수행할 수 있는 라이더가 부족하여 배달이 거절된 경우
BAD_WEATHER: 배달 불가능한 날씨로 인해 배달이 거절된 경우
CLOSE_AGENCY: 배달대행사의 영업이 종료되어 배달이 거절된 경우
CLOSE_STORE: 상점의 영업이 종료되어 배달이 거절된 경우
ETC: 기타 사유로 인해 요청이 거절된 경우
required:
- deliveryAgencyId
- deliveryAgencyName
- isDeliveryPossible
- reason
title: 거절 응답 데이터
required:
- statusCode
- data
title: Response Data (REJECT)
description: 요청이 거절된 경우의 응답 데이터
- type: object
properties:
statusCode:
type: integer
data:
type: array
items:
type: object
properties:
category:
type: string
description: 에러 카테고리
errorCode:
type: string
description: 에러 코드
message:
type: string
description: 에러 메시지
info:
type: array
items:
type: object
properties:
deliveryAgencyId:
type: string
maxLength: 30
description: 배달대행사 아이디
deliveryAgencyName:
type: string
maxLength: 30
description: 배달대행사 이름 해당 배달대행사 정보
required:
- deliveryAgencyId
- deliveryAgencyName
title: 베달대행사 데이터
required:
- category
- errorCode
- message
title: 에러 응답 데이터
required:
- statusCode
- data
title: Response Data (ERROR)
description: 부분 실패(207) 등에서 함께 전달되는 에러 데이터
examples:
배달이 가능한 상태:
value:
statusCode: 200
data:
- deliveryAgencyId: barogo
deliveryAgencyName: 바로고
isDeliveryPossible: true
delayTime: 10
totalExtraCharge: 500
extraCharges:
- dataType: FIXED
type: HOLIDAY
status: 'ON'
charge: 500
- dataType: NONE
type: WEATHER
status: 'ON'
charge: null
pickupMinimumAt: 1674742904640
배달이 불가능한 상태:
value:
statusCode: 200
data:
- deliveryAgencyId: barogo
deliveryAgencyName: 바로고
isDeliveryPossible: false
reason: BAD_WEATHER
일부 성공 (207):
value:
statusCode: 207
data:
- deliveryAgencyId: barogo
deliveryAgencyName: 바로고
isDeliveryPossible: true
delayTime: 10
totalExtraCharge: 500
extraCharges:
- dataType: FIXED
type: WEATHER
charge: 500
pickupMinimumAt: 1674742904640
errors:
- category: BAD_GATEWAY
errorCode: EXTERNAL_SERVER_ERROR
message: '[moacall] fail request delivery agency service'
info:
deliveryAgencyId: moacall
deliveryAgencyName: 모아콜
'400':
description: BAD_REQUEST — SCHEMA_VALIDATE / NOT_ALLOW / REQUEST_JSON_PARSING / INVALID_INPUT / NONE_DELIVERY_AGENCY_MAPPING / NONE_ORDER_AGENCY_MAPPING
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'401':
description: UNAUTHORIZED — EXPIRED_API_KEY / VERIFY_API_KEY_FAIL / ROLE_DENY
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'404':
description: NOT_FOUND — NOT_FOUND_API / NOT_FOUND_RESOURCE / EXTERNAL_NOT_FOUND_RESOURCE
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'409':
description: CONFLICT — DUPLICATED_ID / DUPLICATED
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'429':
description: TOO_MANY_REQUESTS — API 요청 횟수 제한 초과
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'500':
description: INTERNAL_SERVER_ERROR — DB_FAIL / JSON_PARSING / SERVER_ERROR
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'502':
description: BAD_GATEWAY — EXTERNAL_SERVER_ERROR / NOT_ALLOW_EXTERNAL / MAINTENANCE_TIME
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'503':
description: SERVICE_UNAVAILABLE — SERVICE_UNAVAILABLE / EXTERNAL_SERVICE_UNAVAILABLE
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'504':
description: GATEWAY_TIMEOUT — GATEWAY_TIMEOUT / EXTERNAL_SERVER_TIMEOUT
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
components:
schemas:
ErrorResponse:
type: object
title: 에러 응답 데이터
description: Gorela error envelope. Published at https://developer.gorelas.com/api-docs-md/common-doc.md
properties:
statusCode:
type: integer
description: HTTP 상태 코드
error:
type: object
properties:
category:
type: string
description: 에러 카테고리 (errorCategory)
errorCode:
type: string
description: 에러 코드
message:
type: string
description: 에러 메세지
required:
- category
- errorCode
- message
required:
- statusCode
- error
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: '고릴라는 API Key 기반으로 접근 권한을 확인합니다. `Authorization: Bearer {API_Key}`'