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

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);