You need to enable JavaScript to run this app.
导航
同步接口(write)
最近更新时间:2024.07.19 14:55:34首次发布时间:2022.04.13 17:53:21

用于将数据上传至火山引擎服务器。数据预同步、历史数据同步、增量天级数据同步、增量实时数据同步等均会涉及到此接口。
每次请求数据量不超过10000条qps建议不超过100每秒上传的数据条数不超过50000条(请求qps*每次请求中数据条数)。
若既有增量天级数据,也有增量实时数据,必须先接入增量天级数据,再接入增量实时数据。
若仅有增量实时数据,上传后不可再上传增量天级数据。
数据上传接口的超时时间应尽量大,例如设置为5s。当数据上传接口调用失败的话,应重新上传数据。
增量实时数据上报时,建议聚合一批数据一起上报(比如积攒1000条再上报),减小客户端和服务端频繁交互的压力。

请求方法

HTTPS POST

域名

《域名》

Path

《Path内相关变量解释》
/data/api/{application_id}/{topic}?method=write&stage={stage}

请求头

公共请求头部分详见《公共请求头说明》
接口额外请求头:

参数

说明

示例

是否必传

Content-Date

数据产生日期,格式规范:"YYYYMMDD"或"YYYY-MM-DD";例如:"Content-Date:20210411"或"Content-Date:2021-04-11"。
注意:若平台Region为“(海外版)”,则平台选择的同步的“数据日期范围”和“Content-Date”传入数据日期都必须对齐到utc+0时区

20210411或2021-04-11

上传离线数据时必传,实时数据上传时不传

请求体

参数

类型

描述

array[object]

array中的一个object即表示一条数据(例如一条商品数据,一条行为数据等)。

示例

//请求格式list[map<string, object>],如商品数据
[
    { //第一条数据
        "id":"38",
        "title":"good car",
        "cate":"11$##$1101",
        "cate_cnt":2,
        "status":1,
        "brand":"bytedance",
        "shop_id":"test_shop_id",
        "pub_time":1583641807,
        "current_price":0.01
    },
    { //第二条数据
        "id":"38",
        "title":"good car",
        "cate":"11$##$1101",
        "cate_cnt":2,
        "status":1,
        "brand":"bytedance",
        "shop_id":"test_shop_id",
        "pub_time":1583641807,
        "current_price":0.01
    }
]

返回体

参数

参数
类型
描述
status
object
任务执行结果,当status.code为0或不存在时,执行过程未发生任何异常,全部写入成功
errors
object
write接口数据处理错误信息

示例

//请求成功
{
    "status":{
        "message":"OK"
    }
}
//请求失败
{
    "status":{
        "code":1001,
        "message":"Occur error, partial or all data handle fail"
    },
    "errors":[
        {
            "message":"partition_date format error, partition_date:2021031, err:parsing time \"2021031\" as \"20060102\": cannot parse \"1\" as \"02\"",
            "data":"{\"brand\":\"12906\",\"cate\":\"3198$##$3205$##$3353$##$1VN60RKL\",\"cate_cnt\":4,\"spu_id\":\"213131321\",\"cate_name\":\"服饰鞋包$##$女装$##$T恤\",\"size\":\"big\",\"partition_date\":\"2021031\",\"additional_tags\":\"\",\"benefit_money\":20,\"brand_name\":\"千百森\"}"
        }
    ]
}