全球潮汐數據API使用方法，潮汐數據查詢

​

請求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	無響應或超時，接口服務異常請聯系我們

 

演示地址 ：電子海圖，潮汐查詢

​