请求URL
https://data.sailxy.com/Gettide?[请求参数]
请求参数
请求参数包括必选和可选参数,如不填写可选参数将使用其默认值,参数之间使用&
进行分隔。
location
需要查询的潮汐站点,请填写潮汐站点的LocationID,LocationID可通过潮汐站点列表获取
date
选择日期,最多可选择未来10天(包含今天)的数据。日期格式为yyyyMMdd,例如 date=20200531
uid
用户id,获取uid请联系作者。例如 uid=hy2021726
timestamp
当前时间戳,例如 timestamp=1627283926,注意必须是当前时间,时间戳五分钟内有效
key
用户秘钥,使用uid对应的秘钥ukey+timestamp取md5值,例如uid=hy2021726对应的秘钥为abcdef,key参数值就是对adcdef1627283926取MD5
返回数据
{
"code": "200",
"updateTime": "2021-02-04T05:02+08:00",
"fxLink": "http://hfx.link/1",
"tideTable": [
{
"fxTime": "2021-02-06T03:48+08:00",
"height": "2.17",
"type": "H"
},
{
"fxTime": "2021-02-06T10:12+08:00",
"height": "0.21",
"type": "L"
},
{
"fxTime": "2021-02-06T16:53+08:00",
"height": "2.47",
"type": "H"
},
{
"fxTime": "2021-02-06T23:22+08:00",
"height": "0.73",
"type": "L"
}
],
"tideHourly": [
{
"fxTime": "2021-02-06T00:00+08:00",
"height": "1.02"
},
{
"fxTime": "2021-02-06T01:00+08:00",
"height": "1.42"
},
{
"fxTime": "2021-02-06T02:00+08:00",
"height": "1.82"
},
{
"fxTime": "2021-02-06T03:00+08:00",
"height": "2.10"
},
{
"fxTime": "2021-02-06T04:00+08:00",
"height": "2.16"
},
{
"fxTime": "2021-02-06T05:00+08:00",
"height": "2.01"
},
{
"fxTime": "2021-02-06T06:00+08:00",
"height": "1.68"
},
{
"fxTime": "2021-02-06T07:00+08:00",
"height": "1.23"
},
{
"fxTime": "2021-02-06T08:00+08:00",
"height": "0.77"
},
{
"fxTime": "2021-02-06T09:00+08:00",
"height": "0.39"
},
{
"fxTime": "2021-02-06T10:00+08:00",
"height": "0.21"
},
{
"fxTime": "2021-02-06T11:00+08:00",
"height": "0.29"
},
{
"fxTime": "2021-02-06T12:00+08:00",
"height": "0.60"
},
{
"fxTime": "2021-02-06T13:00+08:00",
"height": "1.07"
},
{
"fxTime": "2021-02-06T14:00+08:00",
"height": "1.60"
},
{
"fxTime": "2021-02-06T15:00+08:00",
"height": "2.07"
},
{
"fxTime": "2021-02-06T16:00+08:00",
"height": "2.38"
},
{
"fxTime": "2021-02-06T17:00+08:00",
"height": "2.47"
},
{
"fxTime": "2021-02-06T18:00+08:00",
"height": "2.34"
},
{
"fxTime": "2021-02-06T19:00+08:00",
"height": "2.05"
},
{
"fxTime": "2021-02-06T20:00+08:00",
"height": "1.66"
},
{
"fxTime": "2021-02-06T21:00+08:00",
"height": "1.25"
},
{
"fxTime": "2021-02-06T22:00+08:00",
"height": "0.91"
},
{
"fxTime": "2021-02-06T23:00+08:00",
"height": "0.74"
}
],
"refer": {
"sources": [
"qweather.com"
],
"license": [
"commercial license"
]
}
}
参数 | 描述 |
---|---|
code |
API状态码,具体含义请参考状态码 |
updateTime |
当前API的最近更新时间 |
fxLink |
当前数据的响应式页面,便于嵌入网站或应用 |
tideTable.fxTime |
满潮或干潮时间 |
tideTable.height |
海水高度,单位:米 |
tideTable.type |
满潮(H)或干潮(L) |
tideHourly.fxTime |
逐小时预报时间 |
tideHourly.height |
海水高度,单位:米 |
refer.sources |
原始数据来源,或数据源说明,可能为空 |
refer.license |
数据许可或版权声明,可能为空 |
状态码
通过API接口中的code
字段,可以获取到当前请求的状态,判断请求是否成功或出现错误。
代码 | 说明 |
---|---|
200 | 请求成功 |
204 | 请求成功,但你查询的地区暂时没有你需要的数据。 |
400 | 请求错误,可能包含错误的请求参数或缺少必选的请求参数。 |
401 | 认证失败,可能使用了错误的KEY、数字签名错误、KEY的类型错误(如使用SDK的KEY去访问Web API)。 |
402 | 超过访问次数或余额不足以支持继续访问服务,你可以充值、升级访问量或等待访问量重置。 |
403 | 无访问权限,可能是绑定的PackageName、BundleID、域名IP地址不一致,或者是需要额外付费的数据。 |
404 | 查询的数据或地区不存在。 |
429 | 超过限定的QPM(每分钟访问次数),请参考QPM说明 |
500 | 无响应或超时,接口服务异常请联系我们 |
添加微信联系作者:lvxin6136
最新评论