渠道管理/内容发布

创建抖音打卡

接口说明：创建抖音线下打卡发布入口。API Key 属于接入方；扫码用户不需要 AiToEarn 账号，也无需提前授权或绑定抖音账号。

接入方应保存 recordId。可以直接展示服务端生成的 userAction.qrCodeUrl，也可以使用 userAction.shortLink 自行生成二维码，以便自定义尺寸、样式或添加 Logo。用户扫码后会拉起抖音 App，并在 App 内确认和完成发布。schemeUrl 可用于移动端页面直接尝试拉起抖音 App。创建后的 status 固定为 8，表示等待用户操作，不表示发布成功。

抖音发布完成后，AiToEarn 会通过抖音回调更新发布记录。接入方服务端应使用创建记录时的同一 API Key 调用已有的 GET /api/v2/channels/publish/records/{recordId} 查询结果。二维码和拉起链接均有有效期，请以 expiresAt 为准；过期后需要重新调用本接口。

图片和视频不能混合上传。图片最多 12 张，支持 JPG、JPEG、PNG、BMP，单张最大 20 MB；视频最多 1 个，支持 MP4、AVI、MKV、MOV，最大 1 GB、最长 3600 秒。单个 API Key 每 60 秒最多调用 30 次。

POST

api

channels

douyin

open

offline-qr

curl --request POST \
  --url https://aitoearn.cn/api/v2/channels/douyin/open/offline-qr \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "content": {
    "title": "线下打卡",
    "body": "今天来参加活动 #线下打卡",
    "media": [
      {
        "url": "https://assets.example.com/check-in.mp4"
      }
    ],
    "cover": {
      "url": "https://assets.example.com/check-in-cover.jpg"
    }
  }
}
'

{
  "code": 0,
  "message": "请求成功",
  "data": {
    "recordId": "66c5f23ec7d9b89d23e6b102",
    "status": 8,
    "userAction": {
      "shareId": "7400000000000000000",
      "schemeUrl": "snssdk1128://openplatform/share?state=7400000000000000000",
      "shortLink": "https://aitoearn.cn/api/shortLink/abc123",
      "qrCodeUrl": "data:image/png;base64,iVBORw0KGgo...",
      "expiresAt": "2026-08-22T13:00:00.000Z"
    }
  },
  "requestId": "request_xxx"
}

授权

X-Api-Key

string

header

必填

需要从 AiToEarn 获取 API Key。点击前往「API Key 获取教程」。

请求体

application/json

content

object

必填

线下打卡发布内容

Hide child attributes

content.media

object[]

必填

图片或视频列表，至少传入 1 个媒体。图片最多 12 张，视频最多 1 个，图片和视频不能混合上传

Required array length: 1 - 12 elements

Hide child attributes

content.media.url

string<uri>

必填

媒体 URL

content.media.options

object

媒体处理选项

Hide child attributes

content.media.options.adaptation

object

媒体格式转换选项

Hide child attributes

content.media.options.adaptation.imageFormat

enum<string>

图片和封面格式转换目标

可用选项:

off,

auto,

jpeg,

png,

webp

content.title

string

标题，最多 30 个字符

Maximum string length: 30

content.body

string

正文，可在正文中使用 #话题；最多 5 个话题。标题与去除话题后的正文合计最多 1000 个字符

content.cover

object

视频封面；发布视频时可传入公网可访问的图片 URL

Hide child attributes

content.cover.url

string<uri>

必填

封面 URL

content.cover.options

object

媒体处理选项

Hide child attributes

content.cover.options.adaptation

object

媒体格式转换选项

Hide child attributes

content.cover.options.adaptation.imageFormat

enum<string>

图片和封面格式转换目标

可用选项:

off,

auto,

jpeg,

png,

webp

option

object

抖音发布选项

Hide child attributes

option.short_title

string

抖音短标题，最多 12 个字符

Maximum string length: 12

option.cover_tsp

integer

视频封面时间戳，单位为毫秒

必填范围: x >= 0

option.download_type

enum<integer>

下载权限：1 表示允许下载，2 表示不允许下载

可用选项:

1,

2

option.private_status

enum<integer>

可见范围：0 表示公开，1 表示私密，2 表示好友可见

可用选项:

0,

1,

2

option.poi_id

string

抖音地理位置 POI ID

响应

200 - application/json

请求已被服务处理。业务是否成功以响应体 code === 0 为准。

code

integer

必填

业务状态码。0 表示成功，非 0 表示业务错误。

message

string

必填

响应消息。

data

object

Hide child attributes

data.recordId

string

必填

AiToEarn 发布记录 ID

data.status

enum<integer>

必填

发布状态。创建后固定为 8，表示等待用户在抖音 App 内继续操作

可用选项:

8

data.userAction

object

必填

用户继续完成抖音发布所需的信息

Hide child attributes

抖音分享 ID

data.userAction.schemeUrl

string

必填

用于拉起抖音 App 的 Scheme URL

data.userAction.shortLink

string

必填

HTTPS 拉起短链接；可由接入方自行生成和定制二维码

data.userAction.qrCodeUrl

string

必填

服务端生成的二维码 PNG Data URL，可直接用于 img src

data.userAction.expiresAt

string<date-time>

必填

拉起链接的过期时间

requestId

string

请求 ID。

timestamp

integer

错误响应时间戳，Unix 毫秒。

最后修改于 2026年9月29日

curl --request POST \
  --url https://aitoearn.cn/api/v2/channels/douyin/open/offline-qr \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "content": {
    "title": "线下打卡",
    "body": "今天来参加活动 #线下打卡",
    "media": [
      {
        "url": "https://assets.example.com/check-in.mp4"
      }
    ],
    "cover": {
      "url": "https://assets.example.com/check-in-cover.jpg"
    }
  }
}
'

{
  "code": 0,
  "message": "请求成功",
  "data": {
    "recordId": "66c5f23ec7d9b89d23e6b102",
    "status": 8,
    "userAction": {
      "shareId": "7400000000000000000",
      "schemeUrl": "snssdk1128://openplatform/share?state=7400000000000000000",
      "shortLink": "https://aitoearn.cn/api/shortLink/abc123",
      "qrCodeUrl": "data:image/png;base64,iVBORw0KGgo...",
      "expiresAt": "2026-08-22T13:00:00.000Z"
    }
  },
  "requestId": "request_xxx"
}