릴로
개발자 문서사용자 가이드
커스텀몰 API / 기능 알리기 (capabilities)

커스텀몰 API  /  기능 알리기

기능 알리기 (capabilities)

쇼핑몰이 지원하는 기능을 릴로에 알려요. [연결 테스트]가 이 엔드포인트를 호출하고, 릴로는 여기서 켠 기능만 에이전트와 자동화에 보여 줘요.

GET/v1/capabilities
요청
curl "https://api.mall.example.com/v1/capabilities" \
  -H "Authorization: Bearer $LILLO_API_KEY" \
  -H "X-Lillo-Api-Version: 2026-11-01"
응답 — 200 OK
{
  "data": {
    "api_version": "2026-11-01",
    "spec_version": "1.1",
    "orders": true,
    "shipments_endpoint": false,
    "members": true,
    "products": true,
    "claims": ["cancel", "return", "exchange"],
    "receiver_update": true,
    "memos": true,
    "coupons": true,
    "coupon_issue": true,
    "categories": true,
    "catalog": true,
    "pagination": "cursor",
    "webhooks": []
  }
}

응답 필드

api_versionstring필수

2026-11-01

spec_versionstring선택

구현한 규격 버전. v1.1 기능을 켰다면 "1.1"

ordersboolean필수

주문 조회. 항상 true

shipments_endpointboolean선택

배송 조회 엔드포인트 지원 여부

membersboolean선택

회원 조회

productsboolean선택

상품 검색·상세

claimsstring[]선택

v1.1 접수 종류 — cancel·return·exchange 중 지원하는 것

receiver_updateboolean선택

v1.1 배송지 변경

memosboolean선택

v1.1 주문 메모

couponsboolean선택

v1.1 쿠폰 목록·회원 보유 쿠폰

coupon_issueboolean선택

v1.1 쿠폰 발급

categoriesboolean선택

v1.1 카테고리 목록

catalogboolean선택

v1.1 카탈로그 전체 목록 (지식 ‘상품’ 폴더 동기화)

paginationstring선택

"cursor"(기본) 또는 "offset"(카페24 호환)

webhooksstring[]선택

준비 중. 지금은 []

동작 규칙

  • 빠진 키는 미지원(false)으로 봐요.
  • 이 엔드포인트가 404면 ‘주문 조회만 지원’으로 보고 연결은 성공으로 처리해요.
  • 기능을 켰는데 해당 엔드포인트가 404면 그 기능은 ‘쇼핑몰 미지원’으로 실패 처리하고 담당자에게 보여 줘요.
  • 기능을 바꾸면 콘솔에서 [연결 테스트]를 한 번 더 눌러 주세요. 그때 capabilities를 다시 읽어요.
이전개요다음주문 조회
기능 알리기 (capabilities) · 개발자 문서 | 릴로