릴로
개발자 문서사용자 가이드
커스텀몰 API / 커스텀몰 API 개요

커스텀몰 API  /  개요

커스텀몰 API 개요

자체 개발한 쇼핑몰도 이 규격대로 API를 열면 LIA가 주문·배송·회원·상품을 직접 확인하고 고객에게 답해요. 릴로가 쇼핑몰 API를 호출하는 방식(pull)이라, 쇼핑몰에서 릴로로 따로 보낼 건 없어요.

필드 이름은 카페24 Admin API와 같아요(snake_case). 카페24 응답을 만들어 봤다면 같은 이름으로 응답하면 돼요. 릴로 전용 필드는 ‘확장’으로 표시했어요.

무엇을 할 수 있나요

버전열리는 기능구현
v1.0주문·배송 조회, 회원 조회, 상품 검색·상세주문 조회만 필수
v1.1취소·반품·교환 접수, 배송지 변경, 주문 메모, 쿠폰 조회·발급, 카테고리, 카탈로그 동기화모두 선택

돈이나 고객 정보가 바뀌는 쓰기는 담당자가 승인한 뒤에만 호출해요. 환불 실행은 호출하지 않아요.

빠른 시작

  1. 1

    API 키 발급

    콘솔 설정 > 커넥터 > 커스텀 커머스에서 API 주소(예: https://api.mall.example.com)를 저장하고 API 키를 발급해요. [전환]을 누르면 그 키가 사용 중인 키가 돼요. 키는 쇼핑몰 서버에만 보관하세요.

  2. 2

    엔드포인트 구현

    최소한 GET /v1/orders와 GET /v1/orders/{order_id}를 만들어요. GET /v1/capabilities로 지원하는 기능을 알려 주면 릴로는 그 기능만 써요.

  3. 3

    콘솔에서 연결

    같은 화면에서 [연결 테스트]를 눌러요. 릴로가 GET /v1/capabilities를 호출해 연결을 확인하고, 통과하면 바로 상담에 쓰여요.

인증

릴로는 모든 요청에 발급한 API 키를 Bearer 토큰으로 붙여요. 키가 없거나 틀리면 401을 돌려주세요.

요청 예시 — 인증 헤더
curl "https://api.mall.example.com/v1/capabilities" \
  -H "Authorization: Bearer $LILLO_API_KEY" \
  -H "X-Lillo-Api-Version: 2026-11-01"

Authorizationstring필수

Bearer <API 키>. 키는 상수 시간 비교(timingSafeEqual, hash_equals)로 확인하세요

X-Lillo-Api-Versionstring필수

항상 2026-11-01

X-Lillo-Request-Idstring선택

요청 추적 ID. 있을 때만 붙어요 — 로그에 남겨 두면 문의할 때 빨라요

Idempotency-Keystring조건부

쓰기(v1.1) 요청에만 붙어요. 최대 64자

키 관리

API 키는 로그에 남기지 마세요. 교체는 콘솔에서 발급 → 전환 2단계로 해요. 전환 전까지는 이전 키도 유효해요.

공통 규칙

항목규칙
기본 주소콘솔에 저장한 API 주소 + /v1/...
프로토콜HTTPS만 써요. 릴로는 리다이렉트를 따라가지 않아요
응답 형식단건 { "data": {...} }, 목록 { "data": [...], "meta": { "next_cursor": ... } }
ID문자열 (product_no도 "77")
시각ISO 8601 + 타임존 (2026-11-10T21:14:03+09:00)
금액문자열 십진수. 객체마다 currency 하나 (없으면 KRW)
참/거짓카페24처럼 "T" / "F"
전화번호릴로는 숫자만 보내요 (01012345678)
시간 제한8초. 목표는 p95 1초 이내
호출 제한키당 초당 10회 이상을 권장해요. 넘으면 429

API 목록

버전

이 문서는 API 버전 2026-11-01, 규격 v1.1 기준이에요. ‘준비 중’ 표시는 아직 릴로가 쓰지 않는 항목이에요. 바뀐 내용은 변경 이력에서 확인하세요.

이전커머스 연동다음기능 알리기
커스텀몰 API 개요 · 개발자 문서 | 릴로