开发文档开发文档
文档
官网
控制台
服务协议
更新日志
文档
官网
控制台
服务协议
更新日志
  • 开始使用

    • 如何接入API
    • API计费限流规则
    • API错误代码说明
    • 不同版本区别
    • 联系我们
    • 海洋天气对照表
    • 海洋要素对照表
  • 海洋警报

    • 极端天气预警
    • 海浪警报
    • 风暴潮警报
    • 海冰警报
    • 海啸
  • 海洋环境(国内)

    • 3天预报
    • 7天预报
    • 15天预报
    • 逐小时预报72小时
    • 逐小时预报168小时
    • 逐小时预报360小时
    • 潮汐30天预报
    • 逐小时潮汐预报72小时
    • 逐小时潮汐预报168小时
    • 逐小时潮汐预报360小时
  • 海洋环境(全球)

    • 3天预报
    • 7天预报
    • 15天预报
    • 逐小时预报72小时
    • 逐小时预报168小时
    • 逐小时预报360小时
  • 海洋天气

    • 海洋天气实况
    • 3天预报
    • 7天预报
    • 15天预报
    • 逐小时预报72小时
    • 逐小时预报168小时
    • 逐小时预报360小时
    • 热带气旋
    • 海上强对流数据接口
    • 海雾数据接口
  • 海洋专题

    • 渔区网格
    • 近岸海域
    • 渔场
    • 港口
  • 海洋生态

  • 地理环境

    • 日出日落
    • 月出月落月相
    • 全球水深数据
    • 通用地理环境
  • 旅游专题

    • 钓鱼
    • 赶海
    • 通用旅游指数

状态码一览表

状态码描述
1000请求成功且数据已返回,success 为 true
1001请求被拦截,您可查看 msg 字段了解原因,success 为 false
1002您传递的参数有问题,请检查参数格式,success 为 false
1003系统业务逻辑出现异常,数据缺失或者数据错误,success 为 false
1004系统内部服务器出现异常,success 为 false
1005其他异常,success 为 false

当 API 请求由于权限不足、服务过期等原因导致错误时,API 会返回如下结构的错误信息。你的程序可以根据 success 和 code 来进行相应的处理。下面列举了几种常见的情况。

  1. 应用到期,提示续费充值
{
	"code": "1001",
	"msg": "应用已到期,请重新续费充值后使用。",
	"success": false
}
  1. 应用调用次数用尽
{
	"code": "1001",
	"msg": "调用次数已用尽,请尽快续费充值后使用。",
	"success": false
}
  1. 应用配置了白名单,但当前发起调用的机器未在白名单内,被拦截
{
  "code": "1001",
  "msg": "您配置了IP白名单策略,当前IP未在白名单内。",
  "success": false
}
  1. 由于您的恶意调用,导致应用被封禁
{
	"code": "1001",
	"msg": "由于恶意调用或者触犯了平台相关条例,您的应用已被封禁。",
	"success": false
}
  1. 请求方式错误,比如接口规定是 GET 请求,你用 POST 方式请求
{
    "code": "1004",
    "msg": "当前请求方式错误,请按照开放文档自行检查接口请求方式",
    "success": false
}
  1. 服务器节点内部异常,请联系官方技术人员解决
{
    "code": "1004",
    "msg": "网关出了点问题,请稍后重试",
    "success": false
}
  1. 服务器业务异常,请联系官方技术人员解决
{
    "code": "1003",
    "msg": "服务器业务异常,请联系技术人员",
    "success": false
}
Prev
API计费限流规则
Next
不同版本区别