B2B API – 주문 및 상품 정보를 자동으로 조회
저희 REST API는 고객 계정이 있는 모든 고객이 이용할 수 있으며, 주문 및 상품 정보를 자동으로 조회하고 자체 시스템에 통합할 수 있게 합니다.
인증
모든 API 요청에는 HTTP 헤더에 함께 전송되는 유효한 API-Key가 필요합니다. API 접근은 귀하의 고객 계정에 연결되어 있으며 고객 계정에 기본적으로 제공됩니다.
헤더 형식
X-API-Key: YOUR_API_KEY_HERE Content-Type: application/json Accept: application/json
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을 기준으로 합니다:
https://artumos.com/api/v1
모든 응답은 다음으로 반환됩니다 JSON JSON (Content-Type: application/json).
Rate Limits
| Plan | 요청 / 분 | 요청 / 일 |
|---|---|---|
| 고객 계정 | 60 | 5.000 |
| 확장 한도 | 요청 시 | 요청 시 |
초과 시 다음이 반환됩니다 HTTP 429 Too Many Requests 헤더 Retry-After 에 대기 시간이 초 단위로 포함됩니다.
오류 코드
| HTTP-Code | 의미 |
|---|---|
200 OK | 요청 성공 |
400 Bad Request | 유효하지 않은 매개변수 |
401 Unauthorized | API-Key 누락 또는 유효하지 않음 |
403 Forbidden | 이 리소스에 대한 권한 없음 |
404 Not Found | 리소스를 찾을 수 없음 |
429 Too Many Requests | Rate Limit 초과 |
500 Internal Server Error | 서버 오류 – 지원팀에 문의하세요 |
오류 Response 형식
{
"success": false,
"error": {
"code": "UNAUTHORIZED",
"message": "Invalid or missing API key."
}
}
엔드포인트: 주문
/api/v1/orders
계정의 모든 주문
| Parameter | 유형 | 설명 |
|---|---|---|
page | integer | 페이지 (기본값: 1) |
per_page | integer | 페이지당 항목 (최대 100) |
status | string | paid | pending | all |
{
"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
}
}
}
/api/v1/orders/{order_id}
개별 주문 조회
엔드포인트: 상품 및 주문 정보
/api/v1/orders/{order_id}/codes
주문의 모든 상품 정보
{
"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"
}
]
}
}
/api/v1/codes/{code_id}
개별 상품 정보 조회
엔드포인트: 상품
/api/v1/products
상품 카탈로그 조회
| Parameter | 유형 | 설명 |
|---|---|---|
category | string | 카테고리 슬러그 필터링 |
in_stock | boolean | 재고가 있는 상품만 |
page | integer | 페이지 |
{
"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
{
"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)
자주 묻는 질문
고객 계정이 있는 모든 고객이 API 접근을 사용할 수 있습니다. 고객 계정에 로그인하고 인증된 요청에 해당 API-Key를 사용하세요.
모든 응답은 JSON으로 반환됩니다. 루트 객체에는 항상 다음이 포함됩니다 success: true/false 그리고 다음 중 하나 data 또는 error.
첫 번째 버전에서 API는 주문, 주문 및 상품 정보를 조회하는 데 사용됩니다. 쓰기 가능한 주문 엔드포인트는 이용 가능해지는 즉시 별도로 활성화됩니다.
예. Sandbox는 고객 계정의 „API 접근" 탭에서 활성화할 수 있으며 해당 API-Key에 직접 연결됩니다.