油价查询API文档

概述

本API提供国内最新油价查询,包含以往调价历史。

基础URL:https://eyiming.cn/openApi/youjia/

认证

使用ak进行身份验证:

ak=123

获取最新油价

获取最新油价

GET /openApi/youjia/

参数

参数 类型 是否必需 描述
ak string 验证AK,例如:eyiming
region string 城市,留空则为查所有,例如:广东

请求示例-全部

GET /openApi/youjia/?ak=eyiming

响应示例

{
                "status": "success",
                "code": 200,
                "count": 31,
                "data": [
                  {
                    "region": "北京",//城市
                    "89#": "7.14",
                    "98#": "7.63",
                    "93#": "7.63",
                    "95#": "8.12",
                    "97#": "8.12",
                    "0#": "7.34",
                    "history_list": [//历史调价记录
                      {
                        "date": "2025-02-20",//日期
                        "89#": "7.14",
                        "98#": "7.63",
                        "93#": "7.63",
                        "95#": "8.12",
                        "97#": "8.12",
                        "0#": "7.34"
                      }
                    ]
                  }
                ],
                "response_time": "0.001s"//执行所需要的时间
              }

请求示例-带条件

GET /openApi/youjia/?ak=eyiming&region=广东

响应示例

{
                "status": "success",
                "code": 200,
                "data": {
                  "region": "广东",
                  "89#": "7.1",
                  "98#": "7.65",
                  "93#": "7.65",
                  "95#": "8.29",
                  "97#": "8.29",
                  "0#": "7.3",
                  "history_list": [
                    {
                      "date": "2025-02-20",
                      "89#": "7.1",
                      "98#": "7.65",
                      "93#": "7.65",
                      "95#": "8.29",
                      "97#": "8.29",
                      "0#": "7.3"
                    },
                    {
                      "date": "2025-01-17",
                      "89#": "7.23",
                      "98#": "7.79",
                      "93#": "7.79",
                      "95#": "8.44",
                      "97#": "8.44",
                      "0#": "7.44"
                    },
                    {
                      "date": "2025-01-03",
                      "89#": "6.98",
                      "98#": "7.52",
                      "93#": "7.52",
                      "95#": "8.14",
                      "97#": "8.14",
                      "0#": "7.16"
                    },
                    {
                      "date": "2024-11-07",
                      "89#": "6.92",
                      "98#": "7.46",
                      "93#": "7.46",
                      "95#": "8.08",
                      "97#": "8.08",
                      "0#": "7.1"
                    },
                    {
                      "date": "2024-10-24",
                      "89#": "7.03",
                      "98#": "7.58",
                      "93#": "7.58",
                      "95#": "8.21",
                      "97#": "8.21",
                      "0#": "7.22"
                    },
                    {
                      "date": "2024-10-11",
                      "89#": "6.97",
                      "98#": "7.5",
                      "93#": "7.5",
                      "95#": "8.13",
                      "97#": "8.13",
                      "0#": "7.15"
                    },
                    {
                      "date": "2024-09-21",
                      "89#": "6.86",
                      "98#": "7.39",
                      "93#": "7.39",
                      "95#": "8.01",
                      "97#": "8.01",
                      "0#": "7.03"
                    },
                    {
                      "date": "2024-09-06",
                      "89#": "7.13",
                      "98#": "7.68",
                      "93#": "7.68",
                      "95#": "8.32",
                      "97#": "8.32",
                      "0#": "7.33"
                    },
                    {
                      "date": "2024-08-09",
                      "89#": "7.21",
                      "98#": "7.76",
                      "93#": "7.76",
                      "95#": "8.41",
                      "97#": "8.41",
                      "0#": "7.42"
                    },
                    {
                      "date": "2024-07-26",
                      "89#": "7.43",
                      "98#": "8.01",
                      "93#": "8.01",
                      "95#": "8.68",
                      "97#": "8.68",
                      "0#": "7.66"
                    },
                    {
                      "date": "2024-07-12",
                      "89#": "7.54",
                      "98#": "8.12",
                      "93#": "8.12",
                      "95#": "8.8",
                      "97#": "8.8",
                      "0#": "7.78"
                    },
                    {
                      "date": "2024-06-28",
                      "89#": "7.46",
                      "98#": "8.04",
                      "93#": "8.04",
                      "95#": "8.71",
                      "97#": "8.71",
                      "0#": "7.69"
                    }
                  ]
                },
                "response_time": "0.001s"
              }

错误码

状态码 说明
429 频率限制触发
403 总次数超限
404 未找到相关地区
501 查询失败