API 문서

Mercozy API를 통합하여 상품, 주문, 재고 등을 관리하는 방법을 알아보세요.

시작하기

API 키 받기

관리자로 로그인하여 설정 > 통합 > API 키 로 이동하여 새 키를 생성합니다. 관리자만 권한이 있습니다.

요청에 포함하기

모든 API 요청에 X-API-Key 헤더를 추가하세요.

요청 보내기 시작

HTTP 클라이언트를 사용하여 Mercozy API 엔드포인트와 통신하세요.

인증

모든 API 요청에는 X-API-Key 헤더로 전송되는 유효한 API 키가 필요합니다.

bash

curl https://api.mercozy.com/api/v1/external/products \
  -H "X-API-Key: mk_live_your_key_here"

API 키는 테넌트에 연결되어 있습니다. 비밀로 유지하고 클라이언트 측 코드에 노출하지 마세요.

기본 URL

https://api.mercozy.com/api/v1/external

요청 제한

API 요청 제한은 구독 플랜에 따라 다릅니다.

플랜	요청 제한	API 접근
Free / Standard	API 접근 불가	No
Pro	300 요청/분	Yes
Business	1,000 요청/분	Yes

응답 형식

모든 응답은 JSON 형식으로 반환됩니다.

성공 응답

json

{
  "data": [
    {
      "id": "prod_abc123",
      "name": "Premium Widget",
      "price": 2999,
      "currency": "USD"
    }
  ],
  "meta": {
    "total": 42,
    "page": 1,
    "limit": 20
  }
}

오류 응답

json

{
  "statusCode": 401,
  "message": "Invalid API key",
  "error": "Unauthorized"
}

오류 코드

코드	상태	설명
VALIDATION_ERROR	400	잘못된 요청 매개변수
UNAUTHORIZED	401	유효하지 않거나 누락된 API 키
FORBIDDEN	403	권한 부족
NOT_FOUND	404	리소스를 찾을 수 없음
CONFLICT	409	리소스가 이미 존재하거나 충돌
RATE_LIMITED	429	요청이 너무 많음
INTERNAL_ERROR	500	내부 서버 오류