시스템 인증

Elim Taobao & 1688 API 시스템은 귀하의 필요에 따라 API 리소스에 액세스할 수 있는 두 가지 주요 인증 방법을 지원합니다:

액세스 토큰 (JWT): 정기적인 로그인이 필요한 사용자 인터페이스가 있는 애플리케이션에 적합합니다.
API 키: 로그인 세션을 관리하지 않고 자동화된 시스템 통합(서버 간 통신)에 적합합니다.

1. 액세스 토큰 (JWT)을 통한 인증

이 방법은 단기 액세스 토큰 (JWT)을 얻기 위해 로그인이 필요합니다.

토큰을 받기 위한 로그인

API 세부 정보 보기: 로그인

다음 엔드포인트로 POST 요청을 보냅니다:

POST /v1/auth/login
Content-Type: application/json
Accept: application/json

액세스 토큰 사용 방법

로그인 성공 후 access_token을 받게 됩니다. 이후 모든 API 요청의 헤더에 이 토큰을 포함해야 합니다:

Authorization: Bearer {access_token}
Accept: application/json
Content-Type: application/json

중요 참고사항:

토큰 유효기간은 30일입니다.
최적의 성능을 위해 시스템 캐시(Redis/Memcached)에 토큰을 저장하는 것이 좋습니다.
토큰을 제3자와 공유하지 마십시오.

2. API 키를 통한 인증

API 키는 JWT 코드를 관리하지 않고 애플리케이션이나 소스 코드를 통해 시스템에 자동으로 액세스할 수 있는 인증 방법입니다.

API 키란 무엇인가요?

API 키는 귀하의 계정에 연결된 고유한 식별자 문자열입니다. 각 HTTP 요청의 x-api-key 헤더에 이 키를 포함합니다.

[!IMPORTANT] 보안 중요: API 키는 귀하의 계정과 동일한 액세스 권한을 가집니다. 공용 플랫폼(GitHub, 포럼)이나 신뢰할 수 없는 제3자에게 이 키를 노출하지 마십시오.

API 키 관리

새로 만들기: 대시보드에서 이름(예: Production Server)을 설정하고 Generate를 클릭합니다. 시스템은 전체 키를 단 한 번만 표시합니다.
목록: 활성 키 목록, 생성 날짜 및 마지막 사용 시간을 볼 수 있습니다.
취소 (Revoke): 키가 노출된 경우 즉시 Revoke를 수행하여 액세스 권한을 취소하십시오.

API 키 사용 방법

전송되는 모든 요청의 HTTP 헤더에 x-api-key 필드를 추가합니다.

cURL 예시:

curl -X GET "https://openapi.elim.asia/v1/products/search" \
     -H "x-api-key: your_api_key_here" \
     -H "Content-Type: application/json"

3. 할당량 및 제한 (Quotas & Limits)

모든 인증 방법은 사용자 계정의 리소스 할당량을 따릅니다:

구독 (Subscription): 요금제(Free, Pro, Enterprise)가 만료되면 API 요청이 거부됩니다.
사용 할당량 (Usage Quota): 각 성공적인 요청은 요금제의 월별 총 할당량에서 차감됩니다.
크레딧 (Credits): 요금제 할당량을 모두 사용하면 시스템이 크레딧 잔액에서 자동으로 차감합니다(있는 경우).
속도 제한 (Rate Limit): 시스템 안정성을 보장하기 위해 API 호출 속도 제한이 적용됩니다.

4. 일반적인 오류 코드

오류 코드	의미	해결책
401 Unauthorized	토큰 또는 API 키가 없거나, 잘못되었거나, 만료되었습니다.	`Authorization` 또는 `x-api-key` 헤더를 확인하십시오.
403 Forbidden	계정이 잠겨 있거나 권한이 부족합니다.	대시보드에서 계정 상태를 확인하십시오.
429 Too Many Requests	호출 속도 제한을 초과했습니다.	호출 빈도를 줄이거나 요금제를 업그레이드하십시오.
402 Payment Required	할당량을 모두 사용했으며 남은 크레딧이 없습니다.	요금제를 업그레이드하거나 요청 할당량을 추가 구매하십시오.

5. 코드 예제 (API 키 사용)

JavaScript (Axios)

const axios = require('axios');

const client = axios.create({
  baseURL: 'https://openapi.elim.asia/v1',
  headers: {
    'x-api-key': 'YOUR_API_KEY_HERE',
    'Content-Type': 'application/json',
  },
});

async function searchProduct(keyword) {
  try {
    const response = await client.get('/products/search', { params: { q: keyword } });
    console.log(response.data);
  } catch (error) {
    console.error('Error:', error.response.status);
  }
}

Python (Requests)

import requests

API_URL = "https://openapi.elim.asia/v1/products/search"
HEADERS = {
    "x-api-key": "YOUR_API_KEY_HERE",
    "Content-Type": "application/json"
}

def search_product(keyword):
    response = requests.get(API_URL, headers=HEADERS, params={"q": keyword})
    if response.status_code == 200:
        return response.json()
    return None

이 문서는 Elim Taobao & 1688 API 시스템의 소유입니다. 문의 사항이 있으시면 Telegram으로 연락주시기 바랍니다.