API — 自动发帖接口文档(支持AI/API/Agent自动发帖)

本接口适用于AI/Aagent代理、群发帖系统、第三方系统对接等自动化场景，支持图片和发布数据在一次请求中提交。

接口地址：
https://ershou.co/apipost

请求方式：POST
Content-Type：multipart/form-data（文件+字段）或 application/json（纯JSON）
认证方式：请求头 X-API-Key

测试密钥：Test
测试模式会执行所有检测步骤（图片不处理），但不写入数据库，仅返回检测报告。

正式密钥：申请密钥

请求字段：

字段名	必填	说明
title	是	信息标题
about	是	信息正文
fl	是	分类 ID，可选以下值： 1=二手电脑、2=二手数码,手机、3=二手家电、4=二手家具,家居、6=二手艺术收藏、17=二手机械设备
city	是	城市拼音，可选以下值： beijing=北京、shanghai=上海、tianjin=天津、chongqing=重庆、guangdong=广东 zhejiang=浙江、jiangsu=江苏、sichuan=四川、shandong=山东、fujian=福建 hubei=湖北、hunan=湖南、hebei=河北、henan=河南、anhui=安徽 jiangxi=江西、shanxi=山西、shanxisheng=陕西、gansu=甘肃、guangxi=广西 yunnan=云南、guizhou=贵州、hainan=海南、heilongjiang=黑龙江、jilin=吉林 liaoning=辽宁、neimenggu=内蒙古、xinjiang=新疆、qinghai=青海、ningxia=宁夏 xizang=西藏、hongkong=香港、macao=澳门、taiwan=台湾、World=国外
email	是	11位手机号
mails	否	手机号公开开关：0=不公开，1=公开（默认1）
said	否	联系方式/微信/QQ
images	否	JSON模式传图片URL数组，如 ["https://...jpg"]
ad_pic	否	multipart模式上传单张图片文件

请求示例（JSON）：

curl -X POST https://ershou.co/apipost \
  -H "X-API-Key: Test" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "二手冰箱出售",
    "about": "家用的，用了2年，功能正常",
    "fl": 3,
    "city": "beijing",
    "email": "13800138000"
  }'

请求示例（multipart）：

curl -X POST https://ershou.co/apipost \
  -H "X-API-Key: Test" \
  -F "title=二手冰箱出售" \
  -F "about=家用的，用了2年" \
  -F "fl=3" \
  -F "city=beijing" \
  -F "email=13800138000" \
  -F "ad_pic=@photo.jpg"

返回格式（生产模式-成功）：

{"success":true,"fn":"a904u00000003","url":"https://ershou.co/ershou/a904u00000003.htm","pic_count":1,"image":"2605_a904y00000059.jpg"}

返回格式（测试模式-成功）：

{"success":true,"test":true,"message":"API发布测试均正常通过","fields":"title☑ about☑ fl=3☑ city=beijing☑ email=t***@test.com☑"}

测试流程：
使用测试密钥调用接口，系统执行全部检测步骤：必填校验 → 频率限制 → Spam检测 → 限额检测 → 重复检测 → 自动标签。全部通过后返回检测报告，不写入数据。如有任何检测不通过，返回对应的错误信息。

限制参数说明：

项目	默认值
每日限额	2 条/天/(每个IP or 每个手机号)
标题长度	40 字
正文长度	1200 字
图片大小	10 MB
图片类型	jpg / jpeg / png / gif / webp
发布间隔	2 分钟/同一密钥

联系方式：
如有问题，请[* 联系我们 *]。