빠른 시작

이 가이드를 통해 굿웨어몰 커머스 API를 설정하고 사용할 수 있습니다. 관리콘솔을 통한 API 사용 등록 방법 및 API 요청을 하는 방법을 다룹니다.

굿웨어몰 커머스 API를 사용하려면 먼저 관리콘솔을 통한 커머스 API 사용 등록을 통해 Access Key와 APP Secret을 발급받아야 합니다. 사용등록은 관리콘솔 » 애플리케이션 을 통해 가능합니다.

1. Access Key 및 APP Secret 발급

  • 관리콘솔에 로그인합니다.
  • 애플리케이션 메뉴에서 애플리케이션 추가를 통해 Access Key와 APP Secret을 발급받습니다.
    • Access Key : API 요청을 위한 유니크한 키입니다.
    • APP Secret : 서명(Signature) 생성 시 사용하는 비밀키입니다.
  • 발급받은 Access Key와 APP Secret을 안전하게 보관하세요. 이 정보는 API 인증에 필수적입니다.
  • 서명(Signature) 생성 및 인증헤더 관련 정보는 인증에서 확인하세요.

2. API 호출하기

이제 준비된 Access Key와 Signature를 사용하여 API를 호출할 수 있습니다.

  • Authorization 헤더에 다음 정보를 포함합니다.
    CEA algorithm=HmacSHA256, access-key={Access Key}, signed-date={Signed Date}, signature={Signature}

Request

POST
/v1/welcome
curl -X POST "https://store-api.goodwearmall.com/v1/welcome" \
    -H "Authorization: ${API_AUTH_INFO}"

Response

{
  code: 0,
  message: '굿웨어몰 커머스 API 사용을 환영합니다.'
}

3. 주의 사항

  • APP Secret은 절대 타인과 공유하지 마세요.
  • 매번 새로운 API 호출 시마다 최신 Signed Date와 Signature를 생성해야 합니다.