전제 조건: 쿼리 결과 콜백 URL 웹훅용
Amzpecty에는 Webhook 데이터 푸시 API 알림을 위한 콜백 URL이 필요합니다. 이는 앱에 쿼리 결과(데이터 페이로드 포함)를 알려줍니다. 콜백 URL은 https POST 프로토콜과 유효한 SSL 인증서를 사용하여 전역적으로 액세스할 수 있어야 합니다. Amzpecty는 자체 서명된 SSL 인증서에 웹후크를 성공적으로 보내지 못할 수 있습니다.
Java에서는 doPost 메소드와 함께 HttpServlet을 사용하여 Amzpecty 데이터 페이로드를 수신할 수 있습니다. 다른 프로그래밍 언어에서도 동일한 동등한 솔루션을 구현할 수 있습니다. HTTPS Post 프로토콜을 지원하는 프로그래밍 언어를 사용하여 웹훅 리스너를 구현할 수 있습니다.
콜백 URL이 준비되어 있고 입력되었는지 확인하세요. Amzpecty 대시보드 https://api.amzpecty.com/preferences. Amzpecty가 데이터 조회를 완료한 후 Amzpecty는 JSON 형식의 결과 데이터를 이 URL에 HTTPS 게시합니다. AMZPECTY_CALLBACK_URL 헤더가 요청 호출에 추가되면 기본 설정 콜백 URL 설정보다 우선 적용됩니다.
AMZPECTY-API-SECRET-KEY라는 http 헤더가 요청 출처의 유효성을 검사하기 위해 웹훅 리스너의 https 게시물에 포함됩니다.
단계 및 절차
- 추가 전화 걸기 [ Asin 스냅샷 쿼리 대기열에 Asin/ISBN 추가 ] 또는 [ 제품 변형 쿼리 대기열에 상위 Asin 추가 ] 또는 [ 제품 ID를 ASIN 쿼리 대기열과 일치 ] 등을 사용하여 요청을 쿼리 대기열에 넣습니다.
- Amzpecty API 서버는 검색이 완료되는 즉시 콜백 URL을 호출하여 결과를 보냅니다.
- 애플리케이션은 콜백을 원래 요청과 일치시키기 위해 통화 추가 응답의 제거를 사용할 수 있습니다.
참고 : 변형이 없는 관련 전화의 경우 ASIN이 상위 ASIN 또는 단종된 ASIN이 아닌지 확인하십시오.
상당한 시간이 경과하고 콜백이 수신되지 않는 한 선택적 Get 쿼리를 수행할 필요가 없습니다. 동일한 ASIN에 대해 연속적인 추가 호출을 삼가하십시오.
사용자 에이전트 재정의
클라이언트는 Add 호출 중에 AMZPECTY-USER-AGENT 키와 값을 지정하여 특정 헤더에 대한 기본 User-Agent 헤더를 재정의할 수 있습니다.
Amzpecty API는 포스트백 호출 중에 User-Agent 값을 설정합니다.
부호화
- 요청/응답 데이터 인코딩은 UTF-8이어야 합니다.
끝점
독점 서버 또는 사용자 정의 서버에 대한 사용자 정의 URL에 대해서는 지원팀에 문의하세요.
보안
- Amzpecty와 피어 간의 모든 데이터 교환 연결은 유효한 SSL 인증서가 있는 HTTPS(SSL/TLS)를 통해 이루어져야 합니다.
- Amzpecty는 요청 인증을 위해 비밀 키를 발급합니다(매개변수 이름은 secretKey). 비밀 키는 기본 설정 페이지 > Amzpect API > API 비밀 키에서 찾을 수 있습니다.
쿼리 응답 시간
모든 쿼리 요청을 적시에 처리하기 위해 최선을 다하고 있지만, 우리는 결과 콜백의 적시성을 보장하지 않습니다.. 구현 시 응답 지연을 고려하십시오.
스로틀 요청
API 호출이 거부되는 것을 방지하려면 요청이 최소 1~2초 간격으로 설정되어 있는지 확인하세요. 과도한 버스트 요청을 방지하기 위한 검사가 마련되어 있습니다. 사용자 정의 서버의 예외에 대해서는 지원팀에 문의하세요.
신용공제
데이터를 성공적으로 검색한 경우에만 크레딧이 차감됩니다. Get by RID와 같은 호출은 크레딧을 차감하지 않습니다.
