포스트백 API

Agathe - Technical Writer

마지막 수정: 2024년 11월 26일 22:03

포스트백 API를 사용하면 거래 이벤트가 시스템으로 처리되는 동안 이를 수신할 수 있습니다. 이벤트 API 와 유사한 데이터를 제공하도록 설계되었지만, 이벤트 API 를 통해 데이터를 가져올 필요가 없도록 데이터를 푸시한다는 점이 다릅니다.

API를 사용할 수 있습니다.

계정 요구 사항에는 포스트백(API) 을 사용하지 않는 것이 좋습니다. 대신 시그니쳐 조정 피드 보고서 를 사용하세요.

포스트백 API는 현재 베타 버전으로 개선에 대한 사용자 피드백을 받고 있습니다. 포스트백의 기능은 향후 개선 사항에도 영향을 받지 않습니다. 개선 사항은 API와의 사용자 상호 작용에만 영향을 미칩니다.

포털 에서 포스트백 API 사용에 대한 자세한 지침을 확인할 수 있습니다. 퍼블리셔 대시보드 로그인 자격 증명을 사용하여 로그인합니다.

시작하기 전에 다음이 필요합니다.

또한 사용자 계정이 포스트백을 구현하는 퍼블리셔 ID와 연결되어 있어야 합니다.

현재 포스트백 API는 JSON 형식만 지원합니다. 해당 푸시는 POST가 아닌, GET 요청으로 수행됩니다.

포스트백 API는 동적 URL을 지원하므로 출력을 사용자 지정할 수 있습니다. 포스트백 URL에는 다음이 포함되어야 합니다:

사이트 URL입니다.
는_이벤트=<이벤트> 필드입니다.
포함하려는 다른 필드에 대한 매개변수입니다. 이러한 필드는 사용자 지정을 할 수 있으며, 자세한 내용은 아래의 사용자 지정 가능한 필드 섹션을 참조하세요. 여러 매개변수를 포함하는 경우 앰퍼샌드 (&)로 구분해야 합니다.

예를 들어 웹사이트 주소가 https://www.my-pretty-postback-URL.com 이고 거래_날짜 및 sku_번호 필드를 포함하려는 경우 포스트백 URL은 다음과 같습니다:

https://www.my-pretty-postback-URL.com?is_vent=<is_vent>& transaction_date=<transaction_date>& sku_번호=<sku_번호>

is_event=<is_event> 필드의 목적과 데이터 해석 방법에 대한 자세한 내용은 개발자 포털 의 이벤트 API 트랜잭션 가 이드를 참조하세요.

다음 사용자 지정이 허용됩니다.

예 1: "u1"을 "unique_id"로 이름 바꾸기
예 2: 다음 필드만 포함합니다:
- 거래 날짜
- SKU_번호
- 수량
- 커미션
예제 3: 다음 필드만 포함하고 다음 이름을 변경합니다.
- 거래 날짜
- SKU_번호
- 수량
- 커미션
- "u1"의 이름을 "unique_id"로 바꾸어 줍니다.

포스트백 엔드포인트가 잘못된 데이터를 수신하거나 데이터가 전혀 수신되지 않는 경우 다음을 수행하십시오.

엔드포인트가 당사의 시간 초과 제한인 400ms를 충족하는지 확인합니다. 엔드포인트 URL이 요청에 응답하는 데 400ms 이상 걸릴 경우 당사 서버는 데이터를 전송하지 않습니다. 연결 시도는 한 번만 이루어집니다. 연결 시도가 취소되거나 실패하면 데이터가 다시 전송되지 않습니다.
회원 ID (u1) 필드 가 있는 개별 항목 보고서 를 실행하여 데이터가 있는지 확인합니다. 데이터가 보고서에 표시되려면 최대 4시간이 소요될 수 있습니다.
포스트백이 자동으로 비활성화되어 있는 경우에는 알림이 표시되지 않습니다. 엔드포인트 상태 API 호출을 사용하여 포스트백이 비활성화 또는 활성화 상태인지 확인하는 것이 좋습니다.

또한 개발자 포털 가이드 에서 특정 오류 메시지 목록과 그 의미를 확인할 수 있습니다. 그래도 문제가 지속적으로 발생하면 구체적인 주문 ID 또는 데이터를 받지 못한 날짜를 알아서 고객지원 팀에 문의하세요.

관련 문서