API reference / Connected sessions / Warm reopen lifecycle

Warm reopen lifecycle

Execute foreground resume lifecycle sequence (AppLog foreground launch, SceneSwitchToForeground, FYP pull).

POSTapi.tikultra.com/v1/account/session/warm-reopen15 credits

Upstream: /service/2/app_log//ri/report/aweme/v1/feed/
Access: Growth and up
Runs on: FullPool
Billing: Failed calls are free

Authorization & parameters

x-api-keyheader · stringrequired

Your API key. Create one in API keys.

Body

Send JSON with content-type: application/json.

account_idstringrequired

A connected account, from /dash/sessions or POST /v1/account/import. For example acc_7Hq2.

Client and egress

Executes on the dedicated FullPool mobile context and city-level egress bound to account_id. See Connected sessions.

Response

A 200 returns JSON with stable field names. Every response carries x-credits-cost, x-credits-tier and x-credits-remaining.

Response fields

Key top-level and nested fields decoded from the mobile upstream payload:

status_codeinteger

Upstream TikTok mobile status code (0 indicates success).

account_idstring

Connected session identifier bound to a dedicated FullPool mobile context.

lifecyclestring

Decoded lifecycle value.

device_idstring

Provisioned mobile device identifier.

applog_events_flushedstring[]

Decoded applog events flushed value.

mssdk_scenesstring[]

Decoded mssdk scenes value.

feed_items_pulledinteger

Decoded feed items pulled value.

session_seqinteger

Decoded session seq value.

took_msinteger

Gateway execution or signing latency in milliseconds.

Errors

Errors return a JSON body with a stable code and cost 0 credits. See Errors and retries.

Accounts you own only. Connected sessions are for accounts you own or are authorized to operate. Available on Growth and Scale.

import os from tikultra import TikUltra with TikUltra(api_key=os.environ["TIKULTRA_KEY"]) as client: res = client.request( "POST", "/v1/account/session/warm-reopen", json_body={ "account_id": "acc_7Hq2", }, ) print(res.credits_cost, res.data)

{ "status_code": 0, "account_id": "acc_7Hq2", "lifecycle": "warm_reopen", "device_id": "7392011847562901234", "applog_events_flushed": [ "launch_foreground", "feed_request" ], "mssdk_scenes": [ "switch_to_foreground_105" ], "feed_items_pulled": 6, "session_seq": 15, "took_ms": 690 }