UA 초대자 정보

유저 애퀴지션 CPI를 달성한 유저를 초대한 유저의 VID를 제공합니다. 해당 정보를 활용하여 게임 내에서 유저를 초대한 유저의 정보를 알려줄 수 있습니다.

  • Request URL
상용 URL https://promotion.qpyou.cn/ua/getSenderVid
Sandbox URL https://sandbox-promotion.qpyou.cn/ua/getSenderVid
HTTP Method POST
Content-Type application/json
Data Format JSON
  • Header
필드명 설명 타입 필수여부
Authorization Bearer Authorization으로 certificationKey 유효 판단 String N
  • Request
필드명 설명 타입 필수여부
gameindex 앱센터에 등록된 게임 인덱스 Integer Y
receiver_vid 초대를 받은 유저(receiver)의 VID Integer Y
  • Response
필드명 설명 타입 필수여부
result_code 응답 코드
0: 검증 성공
101: 검색 결과 없음
102: 검색 결과가 1이상
그 외 : 실패
Integer Y
result_message 응답 메시지 String Y
result 쿼리 결과를 담은 객체 Object N
ㄴ sender_vid 초대를 보낸 유저(sender)의 VID String N
  • 호출 예제
curl -L -v
 -d '{"receiver_vid": 40088555, "gameindex": 539}'
 -H "Content-Type: application/json" 
 https://sandbox-promotion.qpyou.cn/ua/getSenderVid
  • 요청 예제
> POST /ua/getSenderVid HTTP/1.1
 > User-Agent: curl/7.29.0
 > Host: sandbox-promotion.qpyou.cn
 > Accept: /
 > Content-Type: application/json
 > Content-Length: 44
  • 응답 예제
< HTTP/1.1 200 OK
< Server: nginx
< Date: Tue, 15 Mar 2022 03:31:34 GMT
< Content-Type: application/json
{"result": {"sender_vid":"40088592"},"result_code":0,"result_message":"success"}