@platfos/naver-commerce-api v1.1.2

NaverCommerceAPI 라이브러리 패키지

목적

네이버 관련 통신은 여러 곳에서 공통적으로 필요로 하기 때문에
한 곳에서 일괄적으로 구현 및 유지보수를 하고자 함.

활용 예시

/** @type {Object[]} */
const categories = await fastify.naverCommerce.api.getCategoryList()

const {
	api: naverApi,
	errors: { STATUS_ERROR: NaverStatusError },
} = fastify.naverCommerce

try{
	await naverApi.getGoodsDetail("유효하지않은채널상품번호")
}catch(error){
	if(error.name === NaverStatusError.name) {
		// 네이버커머스API 쪽 서버가 이상한 경우
	}
	if(error.telegramMessage){
		// 텔레그램 메시지 발송이 필요한 상황
		let message = error.telegramMessage
	}
}

설치

패키지를 내려받는 명령은 다음과 같음:

yarn add @platfos/naver-commerce-api

redis 연동이 선행되어야 하며, 따라서 다음 플러그인이 준비되어 있어야 함:

fastify.redis

.env파일에 반드시 포함해야 함:

# 샌드박스 테스트 환경:
NAVER_COMMERCE_API_HOST=https://sandbox-api.commerce.naver.com/partner
# 실제 운영 환경:
NAVER_COMMERCE_API_HOST=https://api.commerce.naver.com/partner

이용하려는 프로젝트의 index.js 등에서 다음과 같이 등록해야 함:

fastify.register(require('@platfos/naver-commerce-api'))

사용

	// 주문 상세조회
	const productOrderId = '2024020136499371'
	const orderDetail = await fastify.naverCommerce.api.getOrderDetail(productOrderId)

이외에 다른 API들과 그 자세한 사용 예시는 test.js 참조.