抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • 服务端API介绍
  • 小游戏 OpenAPI SDK 总览
  • 接口调用凭证
  • 登录
  • 开放数据
  • 二维码
  • 订阅消息
  • 消息推送客服
  • 游戏礼包
  • 游戏内容安全
  • 推荐流直出游戏能力
  • 动态分享
  • 消息推送
  • 抖音客服平台-客服能力
  • Link链接
  • Schema链接
  • 游戏群标签能力
  • 上报赛事报名用户
  • 选手排名上报
  • 上报赛事报名用户

    收藏
    我的收藏

    接口说明

    小游戏赛事开始前,用户在游戏内赛事报名后调用此接口上报至平台,将用于赛事活动页展示。请于接入前和平台运营对接赛事相关参数的配置

    使用限制

    qps < 1000>

    基本信息

    名称描述
    HTTP URL
    https://minigame.zijieapi.com/mgplatform/api/apps/competition/player/upload
    HTTP Method
    POST
    Scope
    open.ttgame.mgplatform
    权限要求
    请联系小游戏运营申请接入权限

    请求参数

    请求头
    access-token必填String
    示例:08011218462b6b4b5054626e426e50685a7554643144644449413d3d
    content-type必填String
    示例:application/json
    固定值"application/json"
    Body展开全部子属性
    app_id必填String
    示例:tt1234567
    小游戏ID
    competition_id必填String
    示例:101
    赛事ID(请和平台运营对接)
    open_id必填String
    示例:ba253642-0590-40bc-40ca
    用户OpenID
    player_status必填Enum
    示例:1
    参赛状态
    展开子属性
    schedule_idString
    赛程ID(请和平台运营对接)
    sign_up_timeInt64
    报名时间戳,单位秒(当player_status=1时必填)
    请求示例
    curl -X POST "https://minigame.zijieapi.com/mgplatform/api/apps/competition/player/upload" \ -H "access-token: 08011218462b6b4b5054626e426e50685a7554643144644449413d3d" \ -H "content-type: application/json" \ -d '{ "open_id": "ba253642-0590-40bc-40ca", "app_id": "tt1234567", "competition_id": "101", "schedule_id": "1", "player_status": 1, "sign_up_time": 1753773212 }'

    响应参数

    Body
    err_msg必填String
    err_no非0时对应的错误信息文案提示,成功时为空字符串
    err_no必填Int32
    示例:0
    0表示成功
    log_id必填String
    错误日志ID,用于定位问题
    响应示例
    正常响应示例异常响应示例
    { "err_no": 0, "err_msg": "", "log_id": "20250727iYqFshkJBI" }
    切换单列布局

    错误码

    HTTP 状态码错误码错误码描述排查建议
    20028001005
    系统内部错误,请重试
    请求重试,若依然无解请向平台提交反馈
    20028001003
    access_token无效
    重新请求生成access_token
    20028001008
    access_token过期,请刷新或重新授权
    重新请求生成access_token
    20028001007
    参数错误
    请检查入参是否正确