同城API接口1.5

新增马甲功能开关，开启后可使用马甲账号采集信息。

同城信息API插件功能文档


同城信息API插件是一个用于Discuz!论坛的扩展插件，提供了一套完整的API接口，用于管理和发布同城信息，目前支持点微同城信息发布和拼车信息的特殊处理。



信息发布功能

- 支持多模型信息发布
- 支持分类管理
- 支持基础信息（标题、内容、联系方式等）
- 支持地理位置信息（地址、经纬度）
- 支持拼车专用信息发布

拼车功能特性

- 自动同步拼车信息到专用数据表
- 支持出发地和目的地设置
- 支持出发时间设置
- 支持拼车类型分类
- 独立的拼车信息状态管理

信息管理功能

- 支持信息状态管理（上架/下架）
- 支持信息完成状态标记
- 支持信息有效期设置
- 支持信息刷新时间管理
- 防重复提交保护

用户管理

- 支持默认用户ID设置
- 支持微信用户授权验证
- IP白名单控制
- API密钥认证机制

链接适配

- 支持PC端和移动端不同链接格式
- 支持自定义链接模板
- 支持ID参数自动替换



基础接口

- 模型及分类获取接口
- 信息搜索接口
- 信息发布接口
- 微信用户验证接口

接口认证

- Bearer Token认证
- API密钥验证
- IP白名单验证




后台配置项

- 默认用户ID设置
- 默认过期天数设置
- 默认状态设置
- 重复提交检查时间设置
- API密钥设置
- IP白名单设置

链接配置

- PC端链接模板配置
- 移动端链接模板配置
- 支持{id}参数自动替换



接口调用规范

- 必须使用POST方法提交数据
- Content-Type必须为application/json
- 必须包含Authorization请求头
- 时间格式统一使用YYYY-MM-DD HH:mm:ss

拼车信息处理

- 必须同时提供出发地和目的地才会同步到拼车表
- 拼车信息默认状态为1
- 拼车信息会继承主表的基础信息
- 拼车专用字段仅在拼车信息中有效

安全性说明

- 支持API密钥认证
- 支持IP白名单控制
- 数据提交防重复保护
- 微信用户授权验证

错误码说明

| 错误码 | 说明 |
|--------|------|
| 200 | 请求成功 |
| 400 | 请求参数错误 |
| 401 | 认证失败 |
| 403 | IP未授权 |
| 405 | 请求方法错误 |
| 500 | 服务器错误 |

技术支持
如遇到问题，请参考以下步骤：
1. 检查API认证信息是否正确
2. 确认IP是否在白名单中
3. 验证请求参数格式是否正确
4. 查看服务器错误日志获取详细信息
本插件通过结合AI智能体应用，可实现同城信息的智能查询、回复、采集。