关键词管理系统 API 文档

欢迎使用关键词管理系统API！本文档提供完整的API接口说明和使用示例。

基本信息

• API基础URL： https://hub.jp.to4.cn/api/
• 数据格式： JSON
• 字符编码： UTF-8

接口列表

1. 生成网站标题

根据域名和关键词分类生成唯一的网站标题。系统会自动选择该域名尚未使用过的关键词，并确保每个域名不会获得重复的标题。

请求参数

参数名	类型	必填	说明
domain	string	必填	域名，例如：example.com
category	string	可选	关键词分类名称，不指定则从所有分类中随机选择

成功响应示例

{
    "success": true,
    "data": {
        "title": "人工智能 - 专业科技服务平台",
        "keyword": "人工智能",
        "category": "科技",
        "domain": "example.com"
    }
}

错误响应示例

{
    "success": false,
    "error": "没有可用的关键词",
    "code": "NO_KEYWORDS",
    "message": "建议: 1) 添加更多关键词 2) 不指定分类参数"
}

错误代码说明

错误代码	说明
MISSING_DOMAIN	缺少必填参数 domain
NO_KEYWORDS	没有可用的关键词（该域名已用完所有关键词或指定分类下无关键词）
GENERATION_FAILED	标题生成失败（AI服务异常）
INTERNAL_ERROR	服务器内部错误

使用示例

cURL 调用

# 不指定分类
curl "https://hub.jp.to4.cn/api/generate.php?domain=example.com"

# 指定分类
curl "https://hub.jp.to4.cn/api/generate.php?domain=example.com&category=科技"

PHP 调用

<?php
$domain = 'example.com';
$category = '科技';

$url = "https://hub.jp.to4.cn/api/generate.php";
$url .= "?domain=" . urlencode($domain) . "&category=" . urlencode($category);

$response = file_get_contents($url);
$data = json_decode($response, true);

if ($data['success']) {
    echo "生成的标题: " . $data['data']['title'];
    echo "\n关键词: " . $data['data']['keyword'];
    echo "\n分类: " . $data['data']['category'];
} else {
    echo "错误: " . $data['error'];
}
?>

JavaScript 调用

// 使用 Fetch API
fetch('https://hub.jp.to4.cn/api/generate.php?domain=example.com&category=科技')
    .then(response => response.json())
    .then(data => {
        if (data.success) {
            console.log('标题:', data.data.title);
            console.log('关键词:', data.data.keyword);
            console.log('分类:', data.data.category);
        } else {
            console.error('错误:', data.error);
        }
    })
    .catch(error => console.error('请求失败:', error));

// 使用 jQuery
$.ajax({
    url: 'https://hub.jp.to4.cn/api/generate.php',
    data: {
        domain: 'example.com',
        category: '科技'
    },
    success: function(data) {
        if (data.success) {
            console.log('标题:', data.data.title);
        } else {
            console.error('错误:', data.error);
        }
    }
});

Python 调用

import requests
import json

url = "https://hub.jp.to4.cn/api/generate.php"
params = {
    'domain': 'example.com',
    'category': '科技'
}

response = requests.get(url, params=params)
data = response.json()

if data['success']:
    print(f"标题: {data['data']['title']}")
    print(f"关键词: {data['data']['keyword']}")
    print(f"分类: {data['data']['category']}")
else:
    print(f"错误: {data['error']}")

注意事项

• 每个域名在同一分类下的关键词只会使用一次，确保标题唯一性
• 如果指定的分类下没有可用关键词，建议不指定分类参数让系统自动选择
• API调用会被记录到系统日志中，管理员可在后台查看
• 建议使用HTTPS访问API以确保数据安全
• 标题生成依赖于AI配置，未配置AI时使用内置模板

进入管理后台