Sample code for 30+ languages & platforms
Java

TikTok Shop OAuth2

See more TikTok Shop Examples

Demonstrates how to get the initial OAuth2 access token for a TikTop Shop application. This is for desktop applications and scripts only. It is not for server-side code running on a web server.

Chilkat Java Downloads

Chilkat2 Java
import com.chilkatsoft.chilkat2.ChilkatException;
import com.chilkatsoft.chilkat2.FileAccess;
import com.chilkatsoft.chilkat2.JsonObject;
import com.chilkatsoft.chilkat2.OAuth2;

public class ChilkatExample {

    public static void main(String[] args) {
        // This example requires the Chilkat API to have been previously unlocked.
        // See Global Unlock Sample for sample code.

        OAuth2 oauth2 = new OAuth2();

        // This should be the port in the localhost callback URL for your app.
        // The callback URL would look like "http://localhost:3017/" if the port number is 3017.
        oauth2.setListenPort(3017);

        oauth2.setAuthorizationEndpoint("https://services.tiktokshop.com/open/authorize");
        oauth2.setTokenEndpoint("https://auth.tiktok-shops.com/api/v2/token/get");

        // Replace these with actual values.
        oauth2.setClientId("APP_KEY");
        oauth2.setClientSecret("APP_SECRET");

        oauth2.setScope("");

        // See https://partner.tiktokshop.com/doc/page/63fd743c715d622a338c4e5a
        // for information about how to manually get your service_id
        // Once you have the service_id, it should not change.
        oauth2.addAuthQueryParam("service_id", "YOUR_SERVICE_ID");

        // Begin the OAuth2 three-legged flow.  This returns a URL that should be loaded in a browser.
        String url;
        try {
            url = oauth2.startAuth();

            // Launch the system's default browser navigated to the URL.
            oauth2.launchBrowser(url);
        } catch (ChilkatException e) {
            System.out.println(e.getLastErrorText());
            return;
        }

        // Now wait for the authorization.
        // We'll wait for a max of 60 seconds.
        int numMsWaited = 0;
        while ((numMsWaited < 60000) && (oauth2.getAuthFlowState() < 3)) {
            oauth2.sleepMs(100);
            numMsWaited = numMsWaited + 100;
        }

        // If there was no response from the browser within 30 seconds, then
        // the AuthFlowState will be equal to 1 or 2.
        // 1: Waiting for Redirect. The OAuth2 background thread is waiting to receive the redirect HTTP request from the browser.
        // 2: Waiting for Final Response. The OAuth2 background thread is waiting for the final access token response.
        // In that case, cancel the background task started in the call to StartAuth.
        if (oauth2.getAuthFlowState() < 3) {
            oauth2.cancel();
            System.out.println("No response from the browser!");
            return;
        }

        // Check the AuthFlowState to see if authorization was granted, denied, or if some error occurred
        // The possible AuthFlowState values are:
        // 3: Completed with Success. The OAuth2 flow has completed, the background thread exited, and the successful JSON response is available in AccessTokenResponse property.
        // 4: Completed with Access Denied. The OAuth2 flow has completed, the background thread exited, and the error JSON is available in AccessTokenResponse property.
        // 5: Failed Prior to Completion. The OAuth2 flow failed to complete, the background thread exited, and the error information is available in the FailureInfo property.
        if (oauth2.getAuthFlowState() == 5) {
            System.out.println("OAuth2 failed to complete.");
            System.out.println(oauth2.getFailureInfo());
            return;
        }

        if (oauth2.getAuthFlowState() == 4) {
            System.out.println("OAuth2 authorization was denied.");
            System.out.println(oauth2.getAccessTokenResponse());
            return;
        }

        if (oauth2.getAuthFlowState() != 3) {
            System.out.println("Unexpected AuthFlowState:" + oauth2.getAuthFlowState());
            return;
        }

        System.out.println("OAuth2 authorization granted!");
        System.out.println("Access Token = " + oauth2.getAccessToken());

        // Get the full JSON response:
        JsonObject json = new JsonObject();
        json.load(oauth2.getAccessTokenResponse());
        json.setEmitCompact(false);

        // The JSON response looks like this:

        // {
        //   "code": 0,
        //   "message": "success",
        //   "data": {
        //     "access_token": "GCP_3n......",
        //     "access_token_expire_in": 1722342011,
        //     "refresh_token": "GCP_hA......",
        //     "refresh_token_expire_in": 4841467787,
        //     "open_id": "_VIz.......",
        //     "seller_name": "****",
        //     "seller_base_region": "GB",
        //     "user_type": 0,
        //     "granted_scopes": [
        //       "seller.authorization.info",
        //       "seller.delivery.status.write",
        //       "seller.product.basic",
        //       "seller.order.info",
        //       "seller.fulfillment.basic",
        //       "seller.shop.info",
        //       "seller.fulfillment.package.write",
        //       "seller.product.write"
        //     ]
        //   },
        //   "request_id": "20240723......"
        // }

        System.out.println(json.emit());

        // How to get values from the JSON:
        String strVal = "";

        int code = json.intOf("code");
        String message = json.stringOf("message");
        String Access_token = json.stringOf("data.access_token");
        int Access_token_expire_in = json.intOf("data.access_token_expire_in");
        String Refresh_token = json.stringOf("data.refresh_token");
        int Refresh_token_expire_in = json.intOf("data.refresh_token_expire_in");
        String Open_id = json.stringOf("data.open_id");
        String Seller_name = json.stringOf("data.seller_name");
        String Seller_base_region = json.stringOf("data.seller_base_region");
        int User_type = json.intOf("data.user_type");
        String request_id = json.stringOf("request_id");
        int i = 0;
        int count_i = json.sizeOfArray("data.granted_scopes");
        while (i < count_i) {
            json.setI(i);
            strVal = json.stringOf("data.granted_scopes[i]");
            i = i + 1;
        }

        // Save the JSON to a file for future requests, if needed..
        FileAccess fac = new FileAccess();
        fac.writeEntireTextFile("qa_data/tokens/tiktok-shops.json", json.emit(), "utf-8", false);
    }
}