Delivery SaaS API - 자주 묻는 질문 (FAQ)

=== 서비스 기본 ===

Q: Delivery SaaS API는 무엇인가요?
A: 롯데택배, CJ대한통운, 우체국택배 등 여러 택배사의 배송 조회, 등록, 관리를 하나의 RESTful API로 통합한 개발자용 SaaS 서비스입니다.

Q: 무료로 사용할 수 있나요?
A: 네, 월 30,000회 API 호출까지 완전 무료입니다. 이메일만으로 3초 만에 가입할 수 있습니다.

Q: 회원가입은 어떻게 하나요?
A: 이메일 주소를 입력하고 6자리 인증 코드를 받아 입력하면 즉시 API Key가 발급됩니다.

Q: API Key는 어떻게 발급받나요?
A: 회원가입 시 API Key와 Secret Key가 자동으로 발급됩니다. 이 키를 사용하여 모든 API를 호출할 수 있습니다.

=== 지원 택배사 ===

Q: 어떤 택배사를 지원하나요?
A: 현재 롯데택배, CJ대한통운, 우체국택배를 지원합니다. 추가 택배사는 요청 시 빠르게 추가 가능합니다.

Q: 한진택배도 지원하나요?
A: 현재는 지원하지 않지만, 이용자 요청 시 빠르게 추가할 예정입니다. support@delivery-saas.com으로 문의주세요.

Q: 쿠팡 로켓배송도 조회할 수 있나요?
A: 현재는 일반 택배사만 지원하며, 쿠팡 로켓배송은 지원하지 않습니다.

=== 기능 ===

Q: 배송 조회만 가능한가요?
A: 아니요, 배송 조회뿐만 아니라 택배 계정 등록 후 배송 등록, 대량 업로드(최대 1,000건), 발송 내역 조회 등 전체 기능을 사용할 수 있습니다.

Q: 택배 계정 없이도 배송 조회가 가능한가요?
A: 네, 송장번호만 있으면 택배 계정 없이도 배송 조회가 가능합니다.

Q: 택배 계정 등록은 어떻게 하나요?
A: 롯데택배는 ID/PW만 입력하면 즉시 등록되고, CJ대한통운은 ID/PW 입력 후 문자 인증이 필요합니다.

Q: 대량 배송 등록은 몇 건까지 가능한가요?
A: 한 번에 최대 1,000건까지 배송 등록이 가능합니다.

Q: 실시간 배송 추적이 가능한가요?
A: 네, 송장번호로 실시간 배송 상태를 조회할 수 있으며, 택배 계정 등록 시 발송 내역 통계도 제공합니다.

=== 인증 및 보안 ===

Q: API 인증은 어떻게 하나요?
A: 모든 API 호출 시 Header에 "Authorization: Bearer {apiKey}:{secretKey}" 형식으로 인증합니다.

Q: Secret Key를 클라이언트에서 사용해도 되나요?
A: 아니요, Secret Key는 절대 브라우저 등 클라이언트 사이드에 노출하면 안 됩니다. 서버에서만 사용해야 합니다.

Q: API Key를 분실했어요.
A: 현재는 자동 재발급 기능이 없으므로 support@delivery-saas.com으로 문의주세요.

=== 요금제 ===

Q: 무료 플랜의 제한은 무엇인가요?
A: 월 30,000회 API 호출까지 무료이며, 모든 기능을 사용할 수 있습니다.

Q: 무료 플랜을 초과하면 어떻게 되나요?
A: 자동으로 유료 플랜으로 전환되지 않으며, API 호출이 제한됩니다. 유료 플랜으로 업그레이드가 필요합니다.

Q: 요금제 변경은 어떻게 하나요?
A: 현재는 수동 변경만 가능하므로 support@delivery-saas.com으로 문의주세요.

Q: 환불이 가능한가요?
A: 요금제 정책은 이메일로 문의주시면 안내드립니다.

=== 기술 스펙 ===

Q: Base URL은 무엇인가요?
A: https://api-rldhrf7nya-du.a.run.app/api/v1 입니다.

Q: 응답 형식은 무엇인가요?
A: 모든 응답은 JSON 형식입니다.

Q: HTTPS만 지원하나요?
A: 네, 보안을 위해 HTTPS만 지원합니다.

Q: API 호출 제한(Rate Limit)이 있나요?
A: 요금제별로 월 호출 횟수 제한이 있으며, 초당 호출 제한은 별도로 문의주세요.

Q: Webhook을 지원하나요?
A: 현재는 Webhook을 지원하지 않으며, 향후 추가 예정입니다.

=== 계정 관리 ===

Q: 택배 계정 등록 후 courierAccountKey는 무엇인가요?
A: 택배 계정을 등록하면 발급되는 고유 키로, 배송 등록 시 사용합니다.

Q: CJ대한통운 문자 인증은 어떻게 하나요?
A: CJ 계정 등록 시 1522-7513에서 문자가 오면, 해당 번호로 "99"를 답장으로 보내고 3분 이내에 OTP 검증 API를 호출하면 됩니다.

Q: 롯데택배는 왜 문자 인증이 없나요?
A: 롯데택배는 시스템이 자동으로 토큰을 갱신하므로 문자 인증이 필요 없습니다.

Q: CJ 토큰이 만료되면 어떻게 하나요?
A: CJ 계정은 토큰 만료 시 재인증 API를 호출하여 문자 인증을 다시 진행해야 합니다.

=== 사용 사례 ===

Q: 어떤 회사들이 사용하나요?
A: 전자상거래 플랫폼, 물류 관리 시스템, 스타트업 등 배송 관리 자동화가 필요한 다양한 회사들이 사용합니다.

Q: 개인도 사용할 수 있나요?
A: 네, 개인 개발자도 무료 플랜으로 사용 가능합니다.

Q: 쇼핑몰에 연동할 수 있나요?
A: 네, RESTful API이므로 어떤 쇼핑몰이든 연동 가능합니다.

Q: 스마트스토어와 연동할 수 있나요?
A: 네, API를 사용하여 스마트스토어 주문을 택배사에 자동 등록할 수 있습니다.

=== 기타 ===

Q: API 문서는 어디에 있나요?
A: https://delivery-saas.com/docs.html 에서 전체 API 문서를 확인할 수 있습니다.

Q: 샘플 코드가 있나요?
A: 홈페이지와 API 문서에 curl, JavaScript 예제가 포함되어 있습니다.

Q: 기술 지원은 어떻게 받나요?
A: support@delivery-saas.com으로 이메일 문의하거나 GitHub Issues에 등록해주세요.

Q: 새로운 기능 요청은 어떻게 하나요?
A: support@delivery-saas.com으로 이메일 주시거나 GitHub Issues에 Feature Request를 등록해주세요.

Q: SLA(Service Level Agreement)가 있나요?
A: 유료 플랜 가입 시 별도 협의 가능합니다.

Q: 오픈소스인가요?
A: 아니요, 유료/무료 SaaS 서비스이며 오픈소스가 아닙니다.