🧩梦塔论坛接口使用教程

教程分为两个部分:

📁一、API 接口说明

https://api.hvhbbs.cc/?action=get_resource_version&resource_version_id={ID}

支持的 action 列表:

Action 方法 描述
get_threads GET 获取指定论坛的主题列表
get_resource_version GET 获取指定资源版本信息
find_user_by_email GET 通过邮箱查询用户信息(仅管理员可用)

📍接口 1:获取论坛下的主题

GET https://api.hvhbbs.cc/?action=get_thread&thread_id=123

参数:

参数 类型 说明
forum_id int 论坛 ID,必填
page int 页码(可选)
with_threads bool 是否获取主题(true/false)

响应:

{
    "thread": {
        "can_edit": false,
        "can_edit_tags": false,
        "can_hard_delete": false,
        "can_reply": false,
        "can_soft_delete": false,
        "can_view_attachments": false,
        "custom_fields": {},
        "discussion_open": true,
        "discussion_state": "visible",
        "discussion_type": "resource",
        "first_post_id": 190,
        "first_post_reaction_score": 2,
        "Forum": {
            "breadcrumbs": [
                {
                    "node_id": 15,
                    "title": "\u66f4\u591a\u4ea4\u6d41",
                    "node_type_id": "Category"
                }
            ],
            "description": "",
            "display_in_list": true,
            "display_order": 200,
            "node_id": 16,
            "node_name": null,
            "node_type_id": "Forum",
            "parent_node_id": 15,
            "title": "\u8f6f\u4ef6\u7a0b\u5e8f",
            "type_data": {
                "allow_posting": true,
                "can_create_thread": false,
                "can_upload_attachment": false,
                "discussion": {
                    "allowed_thread_types": [
                        "discussion"
                    ],
                    "allow_answer_voting": false,
                    "allow_answer_downvote": false
                },
                "discussion_count": 34,
                "forum_type_id": "discussion",
                "is_unread": true,
                "last_post_date": 1743947206,
                "last_post_id": 2540,
                "last_post_username": "\u5e05\u5230\u88ab\u4eba\u780d",
                "last_thread_id": 10,
                "last_thread_prefix_id": 0,
                "last_thread_title": "\u5f71\u5b50\u6ce8\u5165\u5668",
                "message_count": 104,
                "min_tags": 0,
                "require_prefix": false
            },
            "view_url": "https://www.hvhbbs.cc/forums/16/"
        },
        "highlighted_post_ids": [],
        "is_first_post_pinned": false,
        "is_search_engine_indexable": true,
        "last_post_date": 1737543343,
        "last_post_id": 967,
        "last_post_user_id": 252,
        "last_post_username": "Shad0w",
        "node_id": 16,
        "post_date": 1736427637,
        "prefix_id": 0,
        "reply_count": 1,
        "sticky": false,
        "tags": [],
        "thread_id": 123,
        "title": "3M\u8fd0\u884c\u5e93-\u89e3\u51b3\u6e38\u620f\u62a5\u9519",
        "User": null,
        "user_id": 0,
        "username": "\u5220\u9664\u4f1a\u5458 232",
        "view_count": 27,
        "view_url": "https://www.hvhbbs.cc/threads/123/"
    }
}

📍接口 2:获取资源版本信息

GET https://api.hvhbbs.cc/?action=get_resource_version&resource_version_id=1

响应:

{
    "version": {
        "can_download": false,
        "can_hard_delete": false,
        "can_soft_delete": false,
        "download_count": 108,
        "files": [
            {
                "id": 5,
                "filename": "\u5f71\u5b50\u6ce8\u5165\u5668.zip",
                "size": 384138,
                "download_url": "https://www.hvhbbs.cc/api/resource-versions/1/download?file=5"
            }
        ],
        "rating_avg": 0,
        "rating_count": 0,
        "release_date": 1736181054,
        "Resource": {
            "alt_support_url": "",
            "can_download": false,
            "can_edit": false,
            "can_edit_icon": false,
            "can_edit_tags": false,
            "can_hard_delete": false,
            "can_soft_delete": false,
            "can_view_description_attachments": true,
            "Category": {
                "allow_commercial_external": true,
                "allow_external": true,
                "allow_fileless": true,
                "allow_local": true,
                "can_add": false,
                "can_upload_images": false,
                "description": "",
                "display_order": 800,
                "enable_support_url": true,
                "enable_versioning": true,
                "last_resource_id": 1,
                "last_resource_title": "\u5f71\u5b50\u6ce8\u5165\u5668",
                "last_update": 1736181054,
                "min_tags": 0,
                "parent_category_id": 14,
                "resource_category_id": 17,
                "resource_count": 1,
                "title": "\u6ce8\u5165\u5668",
                "view_url": "https://www.hvhbbs.cc/resources/categories/17/"
            },
            "currency": "",
            "custom_fields": {},
            "download_count": 108,
            "external_url": "",
            "icon_url": null,
            "last_update": 1736181054,
            "prefix_id": 0,
            "price": "0.00",
            "rating_avg": 0,
            "rating_count": 0,
            "rating_weighted": 3,
            "resource_category_id": 17,
            "resource_date": 1736181054,
            "resource_id": 1,
            "resource_state": "visible",
            "resource_type": "download",
            "tag_line": "\u67d0\u8bba\u575b\u642c\u8fd0\u8fc7\u6765\u7684\u7528\u4e8e\u6ce8\u5165DLL",
            "tags": [],
            "title": "\u5f71\u5b50\u6ce8\u5165\u5668",
            "User": {
                "avatar_urls": {
                    "o": "https://www.hvhbbs.cc/data/avatars/o/0/14.jpg?1736179335",
                    "h": "https://www.hvhbbs.cc/data/avatars/h/0/14.jpg?1736179335",
                    "l": "https://www.hvhbbs.cc/data/avatars/l/0/14.jpg?1736179335",
                    "m": "https://www.hvhbbs.cc/data/avatars/m/0/14.jpg?1736179335",
                    "s": "https://www.hvhbbs.cc/data/avatars/s/0/14.jpg?1736179335"
                },
                "can_ban": false,
                "can_converse": false,
                "can_edit": false,
                "can_follow": false,
                "can_ignore": false,
                "can_post_profile": false,
                "can_view_profile": false,
                "can_view_profile_posts": false,
                "can_warn": false,
                "is_staff": false,
                "location": "\ud835\udcee\ud835\udcf5\ud835\udcee\ud835\udcec\ud835\udcfd\ud835\udcfb\ud835\udcf2\ud835\udcec\ud835\udcf2\ud835\udcfd\ud835\udd02",
                "message_count": 7,
                "profile_banner_urls": {
                    "l": "https://www.hvhbbs.cc/data/profile_banners/l/0/14.jpg?1736179023",
                    "m": "https://www.hvhbbs.cc/data/profile_banners/m/0/14.jpg?1736179023"
                },
                "question_solution_count": 0,
                "reaction_score": 314,
                "register_date": 1735911113,
                "signature": "",
                "trophy_points": 48,
                "user_id": 14,
                "user_title": "Well-known member",
                "username": "dadaou",
                "view_url": "https://www.hvhbbs.cc/members/14/",
                "vote_score": 0
            },
            "user_id": 14,
            "username": "dadaou",
            "version": "1.4",
            "view_count": 359,
            "view_url": "https://www.hvhbbs.cc/resources/1/"
        },
        "resource_id": 1,
        "resource_version_id": 1,
        "version_state": "visible",
        "version_string": "1.4",
        "view_url": "https://www.hvhbbs.cc/resources/1/version/1/"
    }
}

📍接口 3:通过邮箱查用户

GET https://api.hvhbbs.cc/[email protected]

响应:

{
    "user": {
        "about": "",
        "activity_visible": true,
        "age": 24,
        "alert_optout": [],
        "allow_post_profile": "members",
        "allow_receive_news_feed": "everyone",
        "allow_send_personal_conversation": "members",
        "allow_view_identities": "everyone",
        "allow_view_profile": "everyone",
        "avatar_urls": {
            "o": "https://www.hvhbbs.cc/data/avatars/o/0/1.jpg?1736358309",
            "h": "https://www.hvhbbs.cc/data/avatars/h/0/1.jpg?1736358309",
            "l": "https://www.hvhbbs.cc/data/avatars/l/0/1.jpg?1736358309",
            "m": "https://www.hvhbbs.cc/data/avatars/m/0/1.jpg?1736358309",
            "s": "https://www.hvhbbs.cc/data/avatars/s/0/1.jpg?1736358309"
        },
        "can_ban": false,
        "can_converse": true,
        "can_edit": true,
        "can_follow": false,
        "can_ignore": false,
        "can_post_profile": true,
        "can_view_profile": true,
        "can_view_profile_posts": true,
        "can_warn": false,
        "content_show_signature": true,
        "creation_watch_state": "watch_email",
        "custom_fields": {
            "siropu_referrer": "MhYa123",
            "siropu_invitation": "",
            "skype": "",
            "facebook": "",
            "twitter": ""
        },
        "custom_title": "MhYa123\u2764\ufe0f",
        "dob": {
            "year": 2000,
            "month": 12,
            "day": 18
        },
        "email": "[email protected]",
        "email_on_conversation": true,
        "gravatar": "",
        "interaction_watch_state": "watch_email",
        "is_admin": true,
        "is_banned": false,
        "is_discouraged": false,
        "is_followed": false,
        "is_ignored": false,
        "is_moderator": true,
        "is_staff": true,
        "is_super_admin": true,
        "last_activity": 1744171697,
        "location": "\u6708\u7403",
        "message_count": 62,
        "profile_banner_urls": {
            "l": "https://www.hvhbbs.cc/data/profile_banners/l/0/1.jpg?1736125349",
            "m": "https://www.hvhbbs.cc/data/profile_banners/m/0/1.jpg?1736125349"
        },
        "push_on_conversation": true,
        "push_optout": [],
        "question_solution_count": 0,
        "reaction_score": 234,
        "receive_admin_email": true,
        "register_date": 1733722640,
        "secondary_group_ids": [
            3,
            6,
            7,
            8
        ],
        "show_dob_date": true,
        "show_dob_year": true,
        "signature": "[SIZE=5][COLOR=rgb(147, 101, 184)]bilibili:[URL]https://space.bilibili.com/670240796[/URL][/COLOR][/SIZE]\n\n[B][I][SIZE=4]\u042f \u0445\u043e\u0447\u0443 \u0431\u044b\u0442\u044c 2D[/SIZE][/I][/B]\n[SIZE=4][B][I]\u6211\u60f3\u53bb\u4e8c\u6b21\u5143\n\u041e\u0446\u0438\u0444\u0440\u0443\u0439\u0442\u0435 \u043c\u0435\u043d\u044f \u0443\u0436\u0435\n\u6211\u5df2\u7ecf\u6210\u4e3a\u865a\u62df\u4eba\u7269\u4e86[/I][/B][/SIZE]",
        "timezone": "Europe/London",
        "trophy_points": 33,
        "use_tfa": true,
        "user_group_id": 2,
        "user_id": 1,
        "user_state": "valid",
        "user_title": "MhYa123\u2764\ufe0f",
        "username": "MhYa123",
        "view_url": "https://www.hvhbbs.cc/members/1/",
        "visible": true,
        "vote_score": 0,
        "warning_points": 0,
        "website": ""
    }
}

失败示例:

{
    "error": "Not authorized",
    "status_code": 403
}

🔐二、用户认证接口

前往