API接口文档
接口说明

本平台提供的API接口,您可以通过API接口实现自动化发稿。

所有接口均使用POST方式请求,数据加密传输,返回JSON格式数据。

您需要登录后才能查看和使用API接口。
1. 获取资源接口
接口说明

获取媒体资源列表,支持按类型、ID等条件筛选。

请求地址
POST https://open-rw-cs.jzguai.com/api/v1/resource
请求参数
参数 类型 必填 说明 示例
model_id int 媒体类型ID 1(网络媒体)
resource_id int 上游媒体ID,不填则查询所有 12786
limit int 每页条数,默认300,最大1000 300
page int 当前页码 1
媒体类型对照表
model_id 类型名称 说明
1网络媒体门户网站、新闻网站等
2自媒体各大自媒体平台
3微信微信公众号
4微博新浪微博
5贴吧百度贴吧
6论坛各大论坛
7问答问答平台
8友链友情链接
9代写文案代写
10小红书小红书笔记
11百度百科百科词条
12品牌宝品牌宝推广
13短视频抖音、快手等
请求示例(PHP)
<?php
$url = "https://open-rw-cs.jzguai.com/api/v1/resource";
$app_key = "YOUR_APP_KEY";
$app_secret = "YOUR_APP_SECRET";

// 请求数据
$data = [
    "model_id" => 1,
    "limit" => 300,
    "page" => 1
];

// 加密数据
$data_info = serialize($data);
$iv = random_bytes(16);
$info['iv'] = base64_encode($iv);
$info['value'] = openssl_encrypt($data_info, 'AES-256-CBC', $app_secret, 0, base64_decode($info['iv']));
$encrypt = base64_encode(json_encode($info));
$sign = md5($encrypt);

$postData = [
    'response' => $encrypt,
    'sign' => $sign,
    'app_key' => $app_key
];

// 发送请求
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $postData);
$response = curl_exec($ch);
curl_close($ch);

// 处理响应
$responseData = json_decode($response, true);
if ($responseData) {
    // 解密响应
    $response = json_decode(base64_decode($responseData['response']), true);
    $iv = base64_decode($response['iv']);
    $decrypted = openssl_decrypt($response['value'], 'AES-256-CBC', $app_secret, 0, $iv);
    $result = unserialize($decrypted);
    print_r($result);
}
?>
响应示例
{
  "data": {
    "current_page": 1,
    "data": [
      {
        "id": 24065,
        "model_id": 1,
        "name": "汉网财经首发",
        "price_original": "10.00",
        "price_proxy": "13.00",
        "status": 1,
        "attributes": {
          "pindaoleixing": "财经金融",
          "zonghemenhu": "其他门户",
          "quyu": "湖北",
          "meitianli": "http://www.cnhan.com/html/biz/20181225/983546.htm",
          "lianjieleixing": "可带网址",
          "shouluxiaoguo": "不包网页收录",
          "weekend_active": 1,
          "meitiquanzhong": "1",
          "tebiehangye": "金融",
          "jiegaoshijian": "18:00"
        }
      }
    ],
    "total": 5144
  },
  "errorCode": "",
  "message": "查询成功",
  "t": 1563243867
}
2. 文章发布接口
接口说明

提交稿件进行发布,系统会自动计算费用并从账户余额扣除。

请求地址
POST https://open-rw-cs.jzguai.com/api/v1/publish
请求参数
参数 类型 必填 说明 示例
model_id int 下游媒体类型ID 1
resource_id int 下游媒体ID 12786
customer_order_id string 下游订单ID ORDER20231215001
customer_batch_id string 同customer_order_id ORDER20231215001
out_model_id int 上游媒体类型ID 1
out_resource_id int 上游媒体ID 12222
price_type int 特殊 价格类型(微信、微博、短视频需要) 0
sale_id int 销售ID,默认0 0
sale_name string 销售名称,默认空 ""
prop JSON 稿件内容,JSON格式 {...}
prop参数说明
字段 类型 必填 说明
biaotistring文章标题
neirongstring文章内容
laiyuanstring来源链接
miaoshustring备注说明
leixingint类型,默认1
tuiguangstring代写推广对象(代写字段)
xuanchuanstring代写宣传要点(代写字段)
xinwenlianjiestring百科新闻链接(百科字段)
yingyezhizhaostring百科营业执照(百科字段)
qiyelogostring百科企业LOGO(百科字段)
fengmianstring微信封面图片(微信字段)
yuanwenlianjiestring微信原文链接(微信字段)
价格类型说明
媒体类型 price_type 说明
微信0头条价格
微信2普条价格
微博0直发价格
微博1任务价格
微博2转发价格
短视频0直发视频价格
短视频2原创视频价格
请求示例(PHP)
<?php
$url = "https://open-rw-cs.jzguai.com/api/v1/publish";
$app_key = "YOUR_APP_KEY";
$app_secret = "YOUR_APP_SECRET";

// 请求数据
$data = [
    "model_id" => 1,
    "resource_id" => 12786,
    "customer_order_id" => "ORDER20231215001",
    "customer_batch_id" => "ORDER20231215001",
    "out_model_id" => 1,
    "out_resource_id" => 12222,
    "sale_id" => 0,
    "sale_name" => "",
    "prop" => json_encode([
        "biaoti" => "测试文章标题",
        "neirong" => "<p>测试文章内容</p>",
        "laiyuan" => "http://example.com",
        "miaoshu" => "测试备注",
        "leixing" => 1,
        "tuiguang" => "",
        "xuanchuan" => "",
        "xinwenlianjie" => "",
        "yingyezhizhao" => "",
        "qiyelogo" => "",
        "fengmian" => "",
        "yuanwenlianjie" => ""
    ])
];

// 加密数据(同获取资源接口)
// ... 加密和发送请求代码 ...
?>
响应示例
{
  "data": [
    {
      "resource_order_id": "120",
      "model_id": "1",
      "resource_id": "12786",
      "resource_order_num": "MP20231215123456"
    }
  ],
  "errorCode": "",
  "message": "",
  "t": 1494227037
}
3. 稿件状态查询接口
接口说明

查询稿件的发布状态,包括回执链接、退稿原因等。

请求地址
POST https://open-rw-cs.jzguai.com/api/v1/status
请求参数
参数 类型 必填 说明
model_id int 资源类型ID
order_id string 下游订单ID
状态码说明
状态码 说明
1011待安排
1001已安排
1002已发布
1004已退稿
1005退单申请
1006改稿中
响应示例
{
  "data": "http://www.example.com/news/123.html",
  "errorCode": "",
  "message": "稿件状态:已发布",
  "status": 1002,
  "t": 1494227037
}
4. 余额查询接口
接口说明

查询账户余额、累计充值和消费信息。

请求地址
POST https://open-rw-cs.jzguai.com/api/v1/wallet
请求参数
参数 类型 必填 说明
start string 开始时间,格式:YYYY-MM-DD
end string 结束时间,格式:YYYY-MM-DD
响应示例
{
  "data": {
    "remaining": "5200.00",
    "recharge": "5200.00",
    "consume": 0,
    "period_consume": "100.00",
    "period_recharge": "500.00"
  },
  "errorCode": "",
  "message": "",
  "t": 1494227037
}
回调接口说明

您需要提供以下回调接口地址给我们,以便接收状态通知:

回调类型 说明 必需
资源变更通知 媒体资源价格、状态变更时通知
稿件进度通知 稿件安排状态变更时通知
稿件回执通知 稿件发布成功,回执链接通知
退稿通知 退稿申请处理结果通知
改稿通知 改稿留言和结果通知

回调接口URL请在用户设置页面配置,我们将主动POST数据到您的回调地址。

错误代码说明
错误代码 说明
ERROR00001接口不存在
ERROR00013app_key异常
ERROR00015请求参数错误
ERROR00020余额不足
ERROR00021媒体资源不存在
ERROR00022订单已存在
ERROR00023IP不在白名单中
ERROR00024签名验证失败
ERROR00025同步时间限制
ERROR00099系统内部错误