周公解梦免费API接口使用指南

estarlee
42 阅读3分钟

接口简介

该API由接口盒子提供，基于传统《周公解梦》典籍，提供数万条解梦数据，帮助用户理解梦境含义和潜在预兆。适用于心理学研究、传统文化应用开发、娱乐咨询平台等场景。

接口基础信息

  • ​请求地址​：https://cn.apihz.cn/api/mingli/zhougong.php

  • ​请求方式​：GET或POST

  • ​请求参数​：

    参数名必填说明示例
    id是用户中心的数字IDid=10000000
    key是用户中心通讯秘钥key=15he5h15ty...
    word是梦境关键词word=捞鱼

  • ​返回参数​：

    参数名说明
    code状态码（200成功，400错误）
    msg状态信息
    data解梦结果数组（最多10条）
    id解梦数据唯一编号
    title梦境标题
    res详细解梦内容（多条用""分隔）

📌 注意：使用专属ID/KEY可避免公共账号频次限制，注册账号获取个人凭证

调用示例

PHP调用示例

php
复制
<?php
$api_url = "https://cn.apihz.cn/api/mingli/zhougong.php";
$user_id = "YOUR_USER_ID";  // 替换为实际ID
$api_key = "YOUR_API_KEY";  // 替换为实际KEY
$dream_word = "捞鱼";       // 梦境关键词

// 构建GET请求
$request_url = $api_url . "?id=" . $user_id . "&key=" . $api_key . "&word=" . urlencode($dream_word);

// 发送请求
$response = file_get_contents($request_url);

// 解析JSON响应
$data = json_decode($response, true);

// 处理结果
if ($data['code'] == 200) {
    echo "找到 " . count($data['data']) . " 条相关解梦:\n";
    foreach ($data['data'] as $item) {
        echo "\n【" . $item['title'] . "】\n";
        // 分割多条解梦内容
        $interpretations = explode("|", $item['res']);
        foreach ($interpretations as $idx => $text) {
            echo ($idx + 1) . ". " . $text . "\n";
        }
    }
} else {
    echo "请求失败: " . $data['msg'];
}
?>

Python调用示例

python
运行
复制
import requests
from urllib.parse import quote

api_url = "https://cn.apihz.cn/api/mingli/zhougong.php"
user_id = "YOUR_USER_ID"   # 替换为实际ID
api_key = "YOUR_API_KEY"   # 替换为实际KEY
dream_word = "捞鱼"        # 梦境关键词

# 构建请求参数
params = {
    "id": user_id,
    "key": api_key,
    "word": dream_word
}

try:
    # 发送GET请求
    response = requests.get(api_url, params=params)
    data = response.json()
    
    if data['code'] == 200:
        print(f"找到 {len(data['data'])} 条相关解梦:")
        for item in data['data']:
            print(f"\n【{item['title']}】")
            # 分割多条解梦内容
            interpretations = item['res'].split("|")
            for idx, text in enumerate(interpretations):
                print(f"{idx + 1}. {text}")
    else:
        print(f"请求失败: {data['msg']}")

except Exception as e:
    print(f"请求异常: {str(e)}")

返回数据结构示例（成功）

json
复制
{
  "code": 200,
  "data": [
    {
      "id": "574",
      "title": "梦见下河捞鱼",
      "res": "孕妇梦见鱼,在大多数情况下,意味着自己会生可爱乖巧的女儿...|梦中看到有一群鱼开心的游来游去,意指你的恋情老是停在原处...|梦见下水捞活鱼,鱼在水中如鱼得水,代表事情的达成大有希望..."
    },
    {
      "id": "3503",
      "title": "女人梦见捞鱼",
      "res": "女人梦见捞鱼,表示恋爱运稍许有些低迷...|结婚前梦见捞鱼,预示你们感情会有阻碍...|考试前梦见捞鱼,考试成绩不错..."
    }
    // ...更多解梦结果（最多10条）...
  ]
}

返回数据结构示例（失败）

json
复制
{
  "code": 400,
  "msg": "通讯秘钥错误。"
}

使用技巧与注意事项

  1. ​关键词优化​：

    • 使用具体意象而非抽象描述（如用"蛇"而非"害怕"）
    • 尝试同义词搜索（如"水"可尝试"河流"、"湖泊"）
    • 组合关键词用空格分隔（如word=水 鱼）

  2. ​结果解析​：

    • 每条结果包含多个解读视角（用"|"分隔）
    • 不同身份解读不同（如孕妇、商人、学生等）
    • 包含真实用户梦境案例参考

  3. ​特殊场景处理​：

    python
运行
复制
# Python结果处理增强版（处理空值和长文本）
for item in data['data']:
    content = item.get('res', '暂无解读')
    # 分段显示长文本
    segments = [seg.strip() for seg in content.split('|') if seg.strip()]
    for i, seg in enumerate(segments):
        print(f"{i+1}. {seg}")

  4. ​使用建议​：

    • 结合用户身份信息优化结果（如自动添加"孕妇"、"学生"等前缀）
    • 对结果进行情感分析（积极/消极预兆）
    • 建立用户梦境记录数据库，实现长期分析

  5. ​数据更新​：

    • 数据库定期更新新增梦境案例
    • 传统文化节日前更新相关主题解读

通过此免费API，开发者可以轻松将传统解梦文化集成到各类应用中，适用于：

  • 心理咨询辅助工具
  • 传统文化教育应用
  • 社交媒体互动机器人
  • 健康睡眠监测软件
  • 娱乐休闲小程序
avatar
文章
阅读
粉丝