B2B 문서

B2B API – 주문 및 상품 정보를 자동으로 조회

저희 REST API는 고객 계정이 있는 모든 고객이 이용할 수 있으며, 주문 및 상품 정보를 자동으로 조회하고 자체 시스템에 통합할 수 있게 합니다.

인증

모든 API 요청에는 HTTP 헤더에 함께 전송되는 유효한 API-Key가 필요합니다. API 접근은 귀하의 고객 계정에 연결되어 있으며 고객 계정에 기본적으로 제공됩니다.

info 별도의 B2B 신청이 필요하지 않습니다: 고객 계정으로 로그인하고, API 탭을 열어 그곳에서 API-Key를 생성하세요. API 접근으로 →

헤더 형식

HTTP Request Header
X-API-Key: YOUR_API_KEY_HERE
Content-Type: application/json
Accept: application/json

cURL 예시

cURL
curl -X GET "https://artumos.com/api/v1/orders" \
  -H "X-API-Key: YOUR_API_KEY_HERE" \
  -H "Accept: application/json"

Base URL

모든 엔드포인트는 다음 Base URL을 기준으로 합니다:

Base URL
https://artumos.com/api/v1

모든 응답은 다음으로 반환됩니다 JSON JSON (Content-Type: application/json).

Rate Limits

Plan요청 / 분요청 / 일
고객 계정605.000
확장 한도요청 시요청 시

초과 시 다음이 반환됩니다 HTTP 429 Too Many Requests 헤더 Retry-After 에 대기 시간이 초 단위로 포함됩니다.

오류 코드

HTTP-Code의미
200 OK요청 성공
400 Bad Request유효하지 않은 매개변수
401 UnauthorizedAPI-Key 누락 또는 유효하지 않음
403 Forbidden이 리소스에 대한 권한 없음
404 Not Found리소스를 찾을 수 없음
429 Too Many RequestsRate Limit 초과
500 Internal Server Error서버 오류 – 지원팀에 문의하세요

오류 Response 형식

JSON
{
  "success": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid or missing API key."
  }
}

엔드포인트: 주문

GET /api/v1/orders 계정의 모든 주문
Parameter유형설명
pageinteger페이지 (기본값: 1)
per_pageinteger페이지당 항목 (최대 100)
statusstringpaid | pending | all
Beispiel-Response
{
  "success": true,
  "data": {
    "orders": [
      {
        "id": "ORD-12345",
        "status": "paid",
        "total": 49.99,
        "currency": "EUR",
        "created_at": "2026-01-15T10:30:00Z",
        "items_count": 2
      }
    ],
    "pagination": {
      "page": 1,
      "per_page": 20,
      "total": 42
    }
  }
}
GET /api/v1/orders/{order_id} 개별 주문 조회

엔드포인트: 상품 및 주문 정보

GET /api/v1/orders/{order_id}/codes 주문의 모든 상품 정보
Beispiel-Response
{
  "success": true,
  "data": {
    "order_id": "ORD-12345",
    "codes": [
      {
        "id": "CODE-789",
        "product_name": "Beispielprodukt vom Marktplatz",
        "product_sku": "ART-PRODUCT-001",
        "product_info": "Hinweise laut Verkäuferangaben",
        "delivery_url": "https://...",
        "delivered_at": "2026-01-15T10:31:00Z",
        "status": "active"
      }
    ]
  }
}
GET /api/v1/codes/{code_id} 개별 상품 정보 조회
warning 상품 및 주문 정보는 해당 주문 및 판매자 정보의 범위 내에서만 사용해야 합니다. 부정한 전달은 이용약관에 위배될 수 있습니다.

엔드포인트: 상품

GET /api/v1/products 상품 카탈로그 조회
Parameter유형설명
categorystring카테고리 슬러그 필터링
in_stockboolean재고가 있는 상품만
pageinteger페이지
Beispiel-Response
{
  "success": true,
  "data": {
    "products": [
      {
        "id": 42,
        "sku": "ART-PRODUCT-001",
        "name": "Beispielprodukt vom Marktplatz",
        "price": 49.99,
        "currency": "EUR",
        "in_stock": true,
        "category": "handmade"
      }
    ]
  }
}

Webhooks

Webhook을 사용하면 주문이나 코드가 제공될 때 실시간 알림을 받을 수 있습니다. Webhook URL은 고객 계정에 등록할 수 있습니다.

이용 가능한 Events

Event설명
order.paid주문이 결제되었습니다
codes.delivered코드가 제공되었습니다
order.refunded주문이 환불되었습니다

Webhook Payload

POST – 귀하의 Webhook 엔드포인트
{
  "event": "codes.delivered",
  "timestamp": "2026-01-15T10:31:05Z",
  "data": {
    "order_id": "ORD-12345",
    "codes_count": 2
  },
  "signature": "sha256=..."
}

Webhook Secret으로 서명을 검증하세요: HMAC-SHA256(payload, webhook_secret)

자주 묻는 질문

누가 B2B API를 사용할 수 있나요?

고객 계정이 있는 모든 고객이 API 접근을 사용할 수 있습니다. 고객 계정에 로그인하고 인증된 요청에 해당 API-Key를 사용하세요.

응답은 어떤 형식인가요?

모든 응답은 JSON으로 반환됩니다. 루트 객체에는 항상 다음이 포함됩니다 success: true/false 그리고 다음 중 하나 data 또는 error.

API로 주문을 할 수 있나요?

첫 번째 버전에서 API는 주문, 주문 및 상품 정보를 조회하는 데 사용됩니다. 쓰기 가능한 주문 엔드포인트는 이용 가능해지는 즉시 별도로 활성화됩니다.

Sandbox 환경이 있나요?

예. Sandbox는 고객 계정의 „API 접근" 탭에서 활성화할 수 있으며 해당 API-Key에 직접 연결됩니다.