宝贝回家

# 宝贝回家 API 文档 > 走失儿童海报生成器 API ## 基本信息 | 项目 | 说明 | |------|------| | 作者 | 尋鯨錄 | | 版本 | 2.6.0 | | 数据来源 | [宝贝回家](https://baobeihuijia.com/) | | 博客 | [https://www.xunjinlu.fun](https://www.xunjinlu.fun) | --- ## 接口地址 ``` GET /index.php?type={type} ``` 或（需服务器配置 URL 重写）： ``` GET /index?type={type} ``` --- ## 请求参数 | 参数名 | 类型 | 必填 | 说明 | |--------|------|------|------| | type | string | 否 | 返回类型，默认 `json` | ### type 参数值 | 值 | 说明 | |----|------| | `json` | 返回 JSON 格式的儿童数据（默认） | | `img` | 返回 PNG 海报图片 | | `base64` | 返回 base64 编码的图片 JSON | | `debug` | 返回服务器调试信息 | --- ## 返回示例 ### 1. JSON 数据 (`type=json`) **请求示例：** ``` GET /index.php?type=json ``` **返回示例：** ```json { "code": 200, "data": { "name": "李光文", "sex": "男", "birthDay": "1993-12-19", "lostDay": "2003-04-15", "lostAddress": "江苏省,无锡市,羊尖", "lostHeight": "110cm", "feature": "头上有个疤还不怎么会说话", "photoUrl": "https://so.baobeihuijia.com/bbhj/special/2013/1/s_db8669ece17587f7.jpg", "detailUrl": "https://www.baobeihuijia.com/bbhj/contents/3/13026.html", "categoryName": "家寻宝贝" }, "api_info": { "developer": "尋鯨錄", "blog": "https://www.xunjinlu.fun", "data_source": "https://baobeihuijia.com/" } } ``` ### 2. 图片 (`type=img`) **请求示例：** ``` GET /index.php?type=img ``` **返回：** - Content-Type: `image/png` - 直接返回 PNG 图片，可在浏览器中预览 - 支持长按保存 ### 3. Base64 图片 (`type=base64`) **请求示例：** ``` GET /index.php?type=base64 ``` **返回示例：** ```json { "code": 200, "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUg..." } ``` ### 4. 调试信息 (`type=debug`) **请求示例：** ``` GET /index.php?type=debug ``` **返回示例：** ```json { "php_version": "8.1.0", "gd_loaded": true, "curl_loaded": true, "font_exists": true, "template_exists": true } ``` --- ## 数据字段说明 | 字段名 | 类型 | 说明 | |--------|------|------| | name | string | 走失儿童姓名 | | sex | string | 性别（男/女） | | birthDay | string | 出生日期（格式：YYYY-MM-DD） | | lostDay | string | 走失日期（格式：YYYY-MM-DD） | | lostAddress | string | 走失地点 | | lostHeight | string | 走失时身高（如：110cm，未知则显示"未知"） | | feature | string | 典型特征描述 | | photoUrl | string | 照片链接 | | detailUrl | string | 详情页链接 | | categoryName | string | 分类名称（如：家寻宝贝、宝贝寻家） | --- ## 错误码说明 | code | 说明 | |------|------| | 200 | 成功 | | 400 | 无效的 type 参数 | | 500 | 服务器错误（未找到数据文件/数据为空/图片生成失败） | --- ## 海报内容 生成的海报图片包含以下内容： 1. **儿童照片** - 左侧区域 2. **基本信息** - 右侧区域 - 姓名 - 性别 - 年龄 - 失踪身高 - 出生日期 - 走失时间 - 联系电话 3. **走失地点** - 底部左侧 4. **典型特征** - 底部中间 5. **二维码** - 右下角（扫码查看详情） --- ## 联系电话 - 节假日：13039194000 - 工作日：0435-3338090 --- ## 使用示例 ### HTML 中直接显示图片 ```html ``` ### JavaScript 获取数据 ```javascript fetch('http://your-domain.com/index.php?type=json') .then(response => response.json()) .then(data => { console.log('儿童姓名:', data.data.name); console.log('走失地点:', data.data.lostAddress); }); ``` ### 获取 Base64 图片 ```javascript fetch('http://your-domain.com/index.php?type=base64') .then(response => response.json()) .then(data => { document.getElementById('poster').src = data.image; }); ``` --- ## 注意事项 1. 每次请求随机返回一条儿童数据 2. 图片支持浏览器预览和长按保存 3. 二维码使用 API 轮询方式生成，避免单点故障 4. 响应后异步发送统计数据，不影响用户体验 --- ## 更新日志 ### v2.6.0 - 添加数据过滤功能，精简返回字段 - 添加统计模块 - 优化响应速度 - 修复 URL 转义问题 ### v2.5.0 - 使用 API 轮询生成二维码 - 修复图片长按保存问题 - 调整二维码与文字间距 ### v2.4.0 - 移除缓存功能，避免杀毒软件误报 - 简化代码结构