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


    Posted by ShellingFord