티스토리 뷰

개발자 이야기

T스토어 API 업데이트 (130222) : 연동규격

개발자센터 지기 ShellingFord 2013. 2. 22. 15:56

Update!

T스토어 API : 상품 페이지 연동규격

+ 업데이트 일자 : 02/22/2013

안녕하세요! 포드 입니다. 

(오늘은 생색을 내야하니깐 덜 찌글하게!)


이미 많은 개발자 분들이 T스토어의 상품 페이지(Product_view)를 연동하기 위해서 이전에 소개드린 http:tsto.re/PID 를 적극적으로 사용하고 계십니다. (링크: 웹?모바일? 상품연결은 tsto . re 하나면 끝! )  

국내 개발사는 물론 Evernote와 같은 해외 개발사(http://tsto.re/0000313304/)도  저희의 연동규격을 사용하는 것을 보면 뿌듯하기도 합니다. ^^ 

tsto.re 와 더불어 쉽게 T스토어를 연동 개발을 할 수 있도록 기존의 API를 다듬고, 새로운 기능을 추가해서 이번에 새롭게 연동규격을 공개하게 됐습니다. 많은 사용 부탁 드립니다~

연동 규격 

App 또는 브라우저와 T스토어를 연동

1. App 또는 웹브라우저와 연동 (intent)
2. 상품, 후기,선물하기 페이지로 이동
3. 지원버전: T store Client v2.05 이상
멀티 다운로드

상품페이지 연동 없이 바로 다운로드        

1. 무료 App/contents의 다운로드 지원
2. 지원버전: T store Client v2.10.00 이상

주의 사항
1. 기존의 product_update/ 는 T스토어 3.0 부터는 동작하지 않습니다. (product_view/에 통합) 
2. 멀티(자동)다운로드는 T store 내 무료 상품에만 적용가능 합니다.  
3. T스토어 버전이 2.05 이하인 경우는 지원이 startActivity()로 업그레이드를 유도하는 방식을 권장 합니다.


T store API: PRODUCT_VIEW

T스토어 상품 페이지 연동 

+ 업데이트 일자 :  02/22/2013

외부 어플리케이션 또는 브라우져와 연동시에 상품 페이지를 호출하는 규격 입니다. 


 1. 단말내 T store 설치여부 판별하기


Android의 Intent 객체를 사용하여, SKAF Collaboration 규격을 통하여 T store Client에 전달됩니다어플리케이션에서는 명시적인 방법으로 Intent를 전달하고, 브라우져에서는 암시적인 방법의 Intent를 사용하기를 권장합니다.


각 연동 규격은 아래에 명기된 T store Client 버전부터 지원이 가능합니다. 따라서 각 어플에서는 해당 규격 호출전에 T store Client의 package name으로 단말에 설치된 버전의 version name을 얻어와서 지원버전 이상인지 확인하는 코드가 추가되어야 합니다. T store Client는 사용자의 단말에 설치된 버전에서 지원되지 않는 API가 호출되었을 경우, 기본 모드로 구동되어 자동 업그레이드를 진행합니다. 


단, 2010년 5월 이전에 출시한 단말에서는 T store 버전이 v2.05 이하인 경우 자동 업데이트가 진행되지 않을 수 있으므로, 이 경우 startActivity()로 업그레이드를 유도하시기 바랍니다. 


아래는 T store가 단말에 설치되어있는지 여부를 판별하는 샘플 코드입니다.

단말의 T store Client PKG 명(com.skt.skaf.A000Z00040)을 근거로 기본 안드로이드 API로 조회하면 됩니다.


PackageManager pm = getPackageManager();

List< ApplicationInfo > appList = pm.getInstalledApplications( 0 );

ApplicationInfo app = null;

int nSize = appList.size();

for( int i = 0; i < nSize; i++ ) {

app = appList.get( i );

if(app.packageName.indexOf( “com.skt.skaf.A000Z00040” ) != -1) {

return true;

}

}

return false;



2. 상품/리뷰/결제 페이지 연동하기 (일반)



PRODUCT_VIEW/(상품PID)/(상품등급)

PRODUCT_VIEW/(상품PID)/(상품등급)/[REVIEW | GIFT?PID= | PAYMENT ]


 PRODUCT_VIEW – prefix
/ - separator

상품PID - 10자리    character string
상품등급 - 1자리     character string
0 : 전체이용가         
1 : 12세 이용가         
2 : 15세 이용가         
4 : 청소년 사용불가
(주의. 3은 존재하지 않음)

REVIEW – 사용후기로 이동
GIFT – 선물하기로 이동

PAYMENT – 결제 페이지로 연동(기구매 시 무료다운로드)

 

EXAMPLE)
PRODUCT_VIEW/0000012345/1
PRODUCT_VIEW/0000012345/1/REVIEW
PRODUCT_VIEW/0000012345/1/GIFT?PID=0000012345

PRODUCT_VIEW/0000012345/1/PAYMENT


지원버전 구분

최소사양: T store Client v2.00.00 이상

( android:versionName="2.34" android:versionCode="3" )


후기/선물하기 연동: T store Client v2.70.01 이상

( android:versionName="2.90" android:versionCode="60" )


결제페이지 연동: T store Client v2.72.00 이상

( android:versionName="2.92" android:versionCode="62" )


주의사항
1. 앱을 제외한 VOD, e북 등 콘텐츠는 연동되지 않습니다. (뮤직App은 연동가능)
2. T스토어 버전이 낮은 경우 업데이트 전에는 연동이 이뤄지지 않습니다. (상품뷰 사용을 권장)


3. 등록한 상품 페이지로 T store 바로 구동하기


명시적 방법으로 T store 상품 페이지를 호출 합니다. 아래 샘플 코드에서 User data 에서 PRODUCT_VIEW/ 다음의 Product ID 부분을 원하는 상품으로 변경하면 됩니다.

- PACKAGE NAME:    com.skt.skaf.A000Z00040
- CLASS NAME:         com.skt.skaf.A000Z00040.A000Z00040

Intent intent = new Intent();
intent.addFlags(Intent.FLAG_ACTIVITY_SINGLE_TOP); //mandatory flag
intent.SetClassName("com.skt.skaf.A000Z00040","com.skt.skaf.A000Z00040.A000Z00040");
intent.setAction("COLLAB_ACTION"); //action
intent.putExtra("com.skt.skaf.COL.URI","PRODUCT_VIEW/00000123456/0".getBytes()); //user data
intent.putExtra("com.skt.skaf.COL.REQUESTER","A000Z00040"); //my App ID
startActivity(intent);


사업자 정보 표시
SK플래닛 | 서진우 | 경기도 성남시 분당구 판교로 264 the Planet | 사업자 등록번호 : 104-86-36968 | TEL : 02-1600-6573 | Mail : devhelper@tstore.co.kr | 통신판매신고번호 : 제2014-경기성남-0036호 | 사이버몰의 이용약관 바로가기
댓글
댓글쓰기 폼