Get Authorization Status

GET

api

channels

accounts

auth

{platform}

status

{sessionId}

Get Authorization Status

curl --request GET \
  --url https://aitoearn.cn/api/v2/channels/accounts/auth/{platform}/status/{sessionId} \
  --header 'X-Api-Key: <api-key>'

import requests

url = "https://aitoearn.cn/api/v2/channels/accounts/auth/{platform}/status/{sessionId}"

headers = {"X-Api-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-Api-Key': '<api-key>'}};

fetch('https://aitoearn.cn/api/v2/channels/accounts/auth/{platform}/status/{sessionId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://aitoearn.cn/api/v2/channels/accounts/auth/{platform}/status/{sessionId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-Api-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "code": 0,
  "message": "Request succeeded",
  "data": {
    "sessionId": "string",
    "status": "pending",
    "requiresSelection": true,
    "errorCode": 1,
    "expiresAt": "2026-07-02T12:00:00.000Z",
    "accountId": "string",
    "accountIds": [
      "string"
    ],
    "accounts": [
      {
        "accountId": "string",
        "platform": "douyin",
        "platformUid": "string",
        "displayName": "string",
        "account": "string",
        "avatarUrl": "string"
      }
    ],
    "selectableAccounts": [
      {
        "platform": "douyin",
        "platformUid": "string",
        "displayName": "string",
        "account": "string",
        "avatarUrl": "string",
        "parentPlatformUid": "string"
      }
    ]
  }
}

Authorizations

X-Api-Key

string

header

required

Need to get API Key from AiToEarn. Click to go to "API Key Obtaining Tutorial".

Path Parameters

platform

string

required

Platform identification

sessionId

string

required

Session ID

Response

200 - application/json

The request has been processed by the service. Business success is determined by whether the response body has code === 0.

code

integer

required

Business status code. 0 means success; non-zero means a business error.

message

string

required

Response message.

data

object

Hide child attributes

data.sessionId

string

required

Authorization Session ID

data.status

enum<string>

required

Authorization Session Status

Available options:

pending,

completed,

failed

data.requiresSelection

boolean

required

Do you need to choose a secondary account?

data.errorCode

number

Authorization failure error code

data.expiresAt

string<date-time>

Authorization session expiration time

data.accountId

string

First local account ID

data.accountIds

string[]

Local account ID list

data.accounts

object[]

List of connected accounts

Hide child attributes

data.accounts.accountId

string

required

Local account ID

data.accounts.platform

enum<string>

required

platform type

Available options:

douyin,

xhs,

wxSph,

KWAI,

youtube,

wxGzh,

bilibili,

twitter,

tiktok,

facebook,

instagram,

threads,

pinterest,

linkedin,

google_business

data.accounts.platformUid

string

required

Platform account UID

data.accounts.displayName

string

required

Platform account display name

data.accounts.account

string

Platform account supplements unique identification

data.accounts.avatarUrl

string

Platform account avatar URL

data.selectableAccounts

object[]

List of selectable platform accounts

Hide child attributes

data.selectableAccounts.platform

enum<string>

required

platform type

Available options:

douyin,

xhs,

wxSph,

KWAI,

youtube,

wxGzh,

bilibili,

twitter,

tiktok,

facebook,

instagram,

threads,

pinterest,

linkedin,

google_business

data.selectableAccounts.platformUid

string

required

Platform account UID

data.selectableAccounts.displayName

string

required

Platform account display name

data.selectableAccounts.account

string

Platform account supplements unique identification

data.selectableAccounts.avatarUrl

string

Platform account avatar URL

data.selectableAccounts.parentPlatformUid

string

Parent platform account UID

requestId

string

Request ID.

timestamp

integer

Error response timestamp in Unix milliseconds.

Start Platform Authorization

Generate Upload Signature

Get Authorization Status

curl --request GET \
  --url https://aitoearn.cn/api/v2/channels/accounts/auth/{platform}/status/{sessionId} \
  --header 'X-Api-Key: <api-key>'

import requests

url = "https://aitoearn.cn/api/v2/channels/accounts/auth/{platform}/status/{sessionId}"

headers = {"X-Api-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-Api-Key': '<api-key>'}};

fetch('https://aitoearn.cn/api/v2/channels/accounts/auth/{platform}/status/{sessionId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://aitoearn.cn/api/v2/channels/accounts/auth/{platform}/status/{sessionId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-Api-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "code": 0,
  "message": "Request succeeded",
  "data": {
    "sessionId": "string",
    "status": "pending",
    "requiresSelection": true,
    "errorCode": 1,
    "expiresAt": "2026-07-02T12:00:00.000Z",
    "accountId": "string",
    "accountIds": [
      "string"
    ],
    "accounts": [
      {
        "accountId": "string",
        "platform": "douyin",
        "platformUid": "string",
        "displayName": "string",
        "account": "string",
        "avatarUrl": "string"
      }
    ],
    "selectableAccounts": [
      {
        "platform": "douyin",
        "platformUid": "string",
        "displayName": "string",
        "account": "string",
        "avatarUrl": "string",
        "parentPlatformUid": "string"
      }
    ]
  }
}

Overview

AI Services/Video Generation

AI Services/Image Generation

AI Services/Large Language Models

Channel Management/Accounts

Channel Management/Publishing

Channel Management/Platforms

Channel Management/Works

Channel Management/Account Groups

Channel Management/Authorization

Asset Management

Authorizations

Path Parameters

Response