Juhe Data API Plugin

Author: leslie2046
Version: 0.0.1
Type: Tool

🔍 Description

Access real-time weather, currency exchange rates, and currency code lists via the Juhe API.

📌 Note: Some currency code queries may return no result depending on data availability.

---

✅ Features

• Weather — Get weather info by city
• Exchange — Convert between two currencies
• Currency List — View common currency codes

---

🛠️ Setup

1. Register at Juhe.cn

2. Get your API Key:

   • Visit 我的API
     
   • Click "申请新数据" → Select "天气预报"
     
   • Copy the generated API Key
     

---

🚀 Example Usage

📍 Weather

JSON
1{
2    "reason": "查询成功!",
3    "result": {
4        "city": "上海",
5        "realtime": {
6            "temperature": "23",
7            "humidity": "43",
8            "info": "多云",
9            "wid": "01",
10            "direct": "西风",
11            "power": "2级",
12            "aqi": "45"
13        },
14        "future": [
15            {
16                "date": "2025-05-10",
17                "temperature": "17\/25℃",
18                "weather": "阴",
19                "wid": {
20                    "day": "02",
21                    "night": "02"
22                },
23                "direct": "西风"
24            },
25            ...
26            {
27                "date": "2025-05-14",
28                "temperature": "21\/29℃",
29                "weather": "阴转小雨",
30                "wid": {
31                    "day": "02",
32                    "night": "07"
33                },
34                "direct": "东南风转南风"
35            }
36        ]
37    },
38    "error_code": 0
39}

💱 Exchange Rate

JSON
1{
2    "reason": "查询成功!",
3    "result": [
4        {
5            "currencyF": "USD",
6            "currencyF_Name": "美元",
7            "currencyT": "CNY",
8            "currencyT_Name": "人民币",
9            "currencyFD": "1",
10            "exchange": "7.2374",
11            "result": "7.2374",
12            "updateTime": "2025-05-10 15:27:00"
13        },
14        {
15            "currencyF": "CNY",
16            "currencyF_Name": "人民币",
17            "currencyT": "USD",
18            "currencyT_Name": "美元",
19            "currencyFD": "1",
20            "exchange": "0.1382",
21            "result": "0.1382",
22            "updateTime": "2025-05-10 15:27:00"
23        }
24    ],
25    "error_code": 0
26}

💹 Currency List

JSON
1{
2  "reason": "查询成功",
3  "result": {
4    "list": [
5            {
6                "name": "美元",
7                "code": "USD"
8            },
9            {
10                "name": "人民币",
11                "code": "CNY"
12            },
13            {
14                "name": "日元",
15                "code": "JPY"
16            },
17            {
18                "name": "欧元",
19                "code": "EUR"
20            },
21      ...
22    ]
23  },
24  "error_code": 0
25}

⛽️ Oil Price(China)

Oil Price

JSON
1{
2	"reason":"success!",
3	"result":[
4		{
5			"city":"北京",
6			"92h":"9.33",
7			"95h":"9.93",
8			"98h":"10.91",
9			"0h":"9.10"
10		},
11		...
12		{
13			"city":"四川",
14			"92h":"9.41",
15			"95h":"10.06",
16			"98h":"10.93",
17			"0h":"9.06"
18		}
19	],
20	"error_code":0
21}

🪙 Gold Price

Gold Price

• Shanghai Gold Exchange

JSON
1{
2    "resultcode": "200",
3    "reason": "SUCCESSED!",
4    "result": [
5        {
6            "Au100g": {
7                "variety": "Au100g",
8                "latestpri": "743.0",
9                "openpri": "743.0",
10                "maxpri": "743.0",
11                "minpri": "743.0",
12                "limit": "0.70%",
13                "yespri": "737.83",
14                "totalvol": "--",
15                "time": "2025-05-16 22:12:19"
16            },
17            ...
18            "IAU99.5": {
19                "variety": "IAU99.5",
20                "latestpri": "--",
21                "openpri": "--",
22                "maxpri": "--",
23                "minpri": "--",
24                "limit": "--",
25                "yespri": "-",
26                "totalvol": "--",
27                "time": "2025-05-16 22:12:19"
28            }
29        }
30    ],
31    "error_code": 0
32}

• Shanghai Future Exchange

JSON
1{
2    "resultcode": "200",
3    "reason": "SUCCESSED!",
4    "result": [
5        {
6            "白银连续": {
7                "name": "白银连续",
8                "latestpri": "8107.00",
9                "change": "-20",
10                "buypri": "8107.000",
11                "buyvol": "16",
12                "sellpri": "8108.000",
13                "sellvol": "10",
14                "tradvol": "22950",
15                "open": "8047.00",
16                "lastclear": "8127.000",
17                "maxpri": "8123.00",
18                "minpri": "8038.00",
19                "position": "105659",
20                "zengcang": "",
21                "time": "2025-05-16 22:14:38"
22            },
23            ...
24            "黄金2606": {
25                "name": "黄金2606",
26                "latestpri": "756.68",
27                "change": "-5",
28                "buypri": "756.160",
29                "buyvol": "1",
30                "sellpri": "756.680",
31                "sellvol": "1",
32                "tradvol": "84",
33                "open": "752.10",
34                "lastclear": "761.680",
35                "maxpri": "757.28",
36                "minpri": "752.10",
37                "position": "100",
38                "zengcang": "",
39                "time": "2025-05-16 22:14:38"
40            }
41        }
42    ],
43    "error_code": 0
44}

---

🐞 Issues & Feedback

• Open an Issue
• Include error messages and steps to reproduce
• ⚠️ Please don’t submit plugin issues to the main Dify repo

---

📄 License

MIT