You need to enable JavaScript to run this app.
导航

API常见错误状态码及处理建议

最近更新时间2024.04.03 17:27:30

首次发布时间2021.09.07 15:06:45

数据服务

状态码

message

含义

处理建议

0或无返回码

OK

上传成功

400

Can't find configuration for tenant/application_id:xxx, please check your tenant/application_id and path.

application_id填错或path写错

检查application_id后重试

400

Can't support scene:xxx, please check your scene/topic.

topic填错了

检查topic后重试

400

Syncing is end or not start in stage(xxx) for tenant/application_id(xxx) topic(xxx), please check the 'stage'

当前使用的stage与项目实际传输阶段不匹配,请参考文档中stage参数说明

检查stage与传输阶段是否匹配。

400

Find no data schema of tenant_id(xxx) tenant/application_id(xxx), please check your tenant_id and retry

tenant_id(租户id)传错,查不到定义的数据schema。

检查schema是否定义或者获取是否失败。

400

Data is empty

数据包为空,请求体中无数据

确认是否传输了数据。

400

The value(xxx) of 'Content-Date' header is invalid, please format it like this: '20060102' or '2006-01-02' or RFC3339

Content-Date header格式非法。

确认Content-Date header是否正确。

400

Syncing is not allowed when acked.

调完done接口不允许再传数据

确保所有数据传输完成再调用done接口。同步失败时也会触发该错误,请重传后再传输。

400

Syncing or ack is not allowed when data cleaning.

数据清理中,不能传输数据或调done接口

等待数据清理完毕后,再传数据

400

Syncing or ack is not allowed when done.

该日期已同步完成,不能传输数据或调done接口

该日期已经处于同步完成状态,只允许重传

400

Syncing or ack is not allowed when failed.

该日期已同步失败,不能传输数据或调done接口

重传失败的日期

400

Syncing or ack is not allowed when skipped.

该日期已跳过,不能传输数据或调done接口

400

Syncing or ack is not allowed when realtime cutoff.

该日期实时数据已断流,不能传输实时数据或调done接口。

若是仅实时接入,请前往平台操作重传后,再使用天级接口传输数据。若是天级+实时,则无法再传输实时数据。

400

Syncing or ack is not allowed when not start.

未点击开始同步,不能传输数据或调done接口

平台点击开始同步后再传数据

400

Ack is not allowed before syncing.

当前日期未传数据不允许调done

先传数据,再调done接口

400

Header Content-Date empty

stage!=‘incremental_sync_streaming’时,必须传‘Content-Date’ header

非实时数据需要添加‘Content-Date’ header

401

Auth fail, xxx

鉴权错误。

检查鉴权相关参数或者鉴权计算过程是否正确。

406

Data date(xxx) should be in valid date list

数据日期不在有效范围。

检查数据日期是否超出平台设定范围。

409

Duplicate submission with request-id: xxx

代表已有过相同request id的请求到达过。一般有两种情况会发生这个错误。一是request id没有使用uuid。二是server已经成功收到数据,但是由于某种原因client以为该次处理失败,发起了重试,使用了相同request id。

检查request id是否使用的是uuid。

413

The count of import items max to 10000

包大小超过限制。

减小包大小到合适的范围。

429

Request is blocked for too many data is waiting to handle, please try again and reduce data count

请求速率太快,导致提交任务阻塞。

降低传输速率。

500

Internal error encountered, errID: xxx, logID: xxx

服务端内部处理错误。

偶发的错误可以通过重试解决。若经常出现您可以联系推荐平台团队。

1001

Occur error, partial or all data handle fail

部分数据处理错误。

您可以查看响应中提供的详细示例错误。

1001

fail to mark some dates done, fail dates and reasons: xxx

done接口设置某些天为done状态失败

您可以查看响应中提供的详细示例错误,查看每天失败的原因

1003

Occur a temporary internal error, please try again

稳定性抖动导致的错误,需重试。

重试。

1005

Internal timeout

处理过程中超时,导致部分数据可能未被导入。

重试或者调大服务器可处理时间。

推荐服务

状态码

message

含义

处理建议

0或200或无返回码

OK

请求推荐接口成功/callback接口成功

400

Can't find configuration for tenant/application_id:xxx, please check your tenant/application_id and path.

application_id填错或path写错

检查application_id后重试

400

User id is empty

user id为空。

请求体里填充合法的user id。

400

Request id is empty

request id为空。

请求header里填充合法的request id。

401

auth fail, xxx

鉴权错误。

检查鉴权相关参数或者鉴权计算过程是否正确。

429

request too fast, please reduce the qps

服务被限流

提高栏位的QPS设置数值或者降低请求量。

500

internal error encountered, errID: xxx, logID: xxx

推荐接口发生内部错误。

若经常出现您可以联系推荐平台团队。