宝贝回家

# 宝贝回家 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 - 移除缓存功能，避免杀毒软件误报 - 简化代码结构

> **由 AI 生成**：本文档由 AI 根据接口配置自动生成，仅供参考，实际接口行为以实时返回为准。 ### 接口简介 本接口用于获取宝贝回家公益平台的走失儿童信息，支持返回JSON数据或生成包含儿童照片、基本信息、走失地点等详细信息的海报图片。典型场景包括公益信息展示、寻人海报生成等。接口无需鉴权，可直接调用。 ### 请求说明 - **请求地址**：`https://api.xunjinlu.fun/api/babygome/index.php` - **HTTP方法**：GET - **常用请求头**： `Accept: application/json`（默认）或 `Accept: image/*`（当type=img时） ### 请求参数表 | 名称 | 类型 | 必填 | 说明 | |------|--------|------|--------------------------| | type | string | 否 | 返回类型：`json`（默认）、`img` | ### 返回字段表 | 字段名 | 类型 | 说明 | |-----------------|--------|--------------------------| | code | int | 状态码（200表示成功） | | data | object | 儿童详细信息对象 | | └─name | string | 姓名 | | └─sex | string | 性别 | | └─birthDay | string | 出生日期 | | └─lostDay | string | 走失日期 | | └─lostAddress | string | 走失地点 | | └─lostHeight | string | 走失时身高 | | └─feature | string | 典型特征 | | └─photoUrl | string | 照片链接 | | └─detailUrl | string | 详情页链接 | | └─categoryName | string | 分类名称（如“家寻宝贝”） | | api_info | object | 接口元信息对象 | | └─developer | string | 开发者名称 | | └─blog | string | 开发者博客链接 | | └─data_source | string | 数据来源链接 | ### 返回JSON示例 **成功示例**（默认JSON返回）： ```json { "code": 200, "data": { "name": "白帅南", "sex": "男", "birthDay": "1994-08-12", "lostDay": "1999-11-02", "lostAddress": "河南省,郑州市火车站", "feature": "孩子当时只有五岁半...", "photoUrl": "https://...", "detailUrl": "https://...", "categoryName": "家寻宝贝" }, "api_info": { "developer": "尋鯨錄", "blog": "https://www.xunjinlu.fun", "data_source": "https://baobeihuijia.com/" } } ``` **失败示例**（非200状态码）： ```json { "code": 400, "message": "参数错误" } ``` ### 错误与状态 - **HTTP状态码**： `200` 请求成功 `400` 参数错误 `500` 服务器错误 - **业务状态码**：以实际返回的 `code` 和 `message` 为准，无公开错误码表。 ### 调用示例 **直接访问** ``` https://api.xunjinlu.fun/api/babygome/index.php?type=json ``` 浏览器打开此URL获取JSON数据。 **cURL** ```bash curl -X GET "https://api.xunjinlu.fun/api/babygome/index.php?type=img" -H "Accept: image/*" ``` 获取图片类型响应。 **Python requests** ```python import requests url = "https://api.xunjinlu.fun/api/babygome/index.php" params = {"type": "json"} response = requests.get(url, params=params) data = response.json() # 解析JSON print(data["data"]["name"]) # 输出姓名 ``` **PHP** ```php ``` **HTML** ```html ```