优采云POST发布接口开发文档

目前，优采云已支持数十款建站系统和自媒体平台的自动发布，但市面上的建站源码众多，且许多公司的网站都是自主开发，为了解决这些网站的自动发布问题，我们开发了POST发布方式，供您自主对接。

POST发布接口是您网站内的一个或一组程序，通常以一个网址的形式提供给优采云，优采云文章采集或生成完毕后，会主动通过http请求，以POST方式，把文章数据发送到您提供的网址。您的服务器对应网址收到文章数据后，自行提取所需数据，自行实现数据处理和保存。

接口开发第一步：创建接口地址

您需要创建一个接收POST请求的网址，作为接口地址。这一步通常需要在您网站适当位置创建一个可以被访问的文件，基本要求如下：

1. 接收POST请求；
2. 允许未登录的访问，或接收Cookie进行登录验证；
3. 确保此网址不会改变；

我们对接口地址无任何要求，比如，您的网站首页地址是https://www.abc.com/，接口地址可以是直接指向某个文件，如https://www.abc.com/123.php或https://www.abc.com/xyz/123.asp，也可以是经过程序做route路由后的地址，如https://www.abc.com/888或https://www.abc.com/xyz/789/等等，也可以是其他任何格式，网址可以带参数，也可以不带参数，只要通过该网址能正常访问到接口程序即可。

接口开发第二步：接口配置

1. 在优采云左侧栏点击“发布接口配置”，在发布接口配置页面，选择POST接口：

2. 系统会显示POST接口配置界面，您需要把上面创建的接口地址填写到接口地址栏，注意此处是完整网址：

 3. 点击下方添加字段按钮，添加几个新的字段，输入字段名称，选择或输入字段值：

关于字段名，所有字段名您都可以自定义，另外支持通过 Headers.Cookie 的格式添加任意请求头，系统在发起请求时，会将它们添加到请求头中，而非在POST数据中。

默认传输格式为 x-www-form-urlencoded ，如果需要以 json 格式传输，设置 Headers.Content-Type 的值为 application/json 即可。

此外，字段名还支持几个简单的函数调用：

.to_array ：json格式 -> 数组格式
.to_json ：数组格式 -> json格式
.join ：数组格式 -> 字符串格式 （英文逗号分隔）
.explode ：字符串格式 -> 数组格式 （英文逗号分隔）

关于字段值，支持输入自定义内容，或选择系统数据字段。当输入框为空时，鼠标点击输入框，会显示系统数据字段，直接选择你所需的字段内容即可。

建议至少添加一个密钥字段或Cookie字段，用于验证请求来源，拒绝所有非法访问。

4. 设置发布成功标识，并保存接口配置。

发布成功标识的意思是，如果您的接口输出信息包含所选字符，我们系统就认为文章保存是成功的，否则就认为是失败的。注意发布成功标识可以是多个，也可以是单个，还可以用后面的自定义框输入，所有勾选和输入的字符串都会被视为发布成功。

接口开发第三步：接口程序编写

这一步需要在您网站内进行程序编写，一般情况由您自己负责。（由于接口可以发送cookie，事实上可以直接登录大多数的网站后台，模拟人工发布文章，所以并不一定需要开发）

您首先要做的是接收数据。在PHP中，您通常可以用$_POST或file_get_contents("php://input")获取所有数据；在asp中，通常可以用Request.Form获取所有数据；在ASP.NET中，通常可以通过读取context.HttpContext.Request.Body数据流获取所有数据。优采云总是使用UTF-8编码发送数据，请您在收到数据后进行编码转换，以符合您的网站编码。

比如我们在接口文件中写入一个PHP代码：

<?php
print_r($_POST);
?>

我们将得到整个数据，格式如下：

Array
(
    [token] => 123456
    [title] => 这是文章标题
    [body]  => <p>这是文章正文</p>
    [catid] => 1
)

接口收到数据后，您通常需要实现的功能如下：

1. 判断密钥是否正确；
2. 判断栏目ID是否存在；
3. 提取正文中的图片网址，进行本地化或者上传云存储，提取缩略图，生成水印等等；
4. 对长文进行自动分页，在适当位置插入分页符；
5. 根据文章标题、关键词、tag标签等查找相关文章，创建内链；
6. 为正文html添加css样式，实现自动排版；
7. 自动保存tags标签；
8. 保存文章数据到数据库；
9. 自动生成静态页面；
10. 获取文章URL，主动推送到百度；
11. 如果文章保存成功，输出发布成功标识，否则输出错误信息以便调试。

以上数据处理，您可以根据需求决定，优采云不做任何规定，您只需确保最终结果符合您的需求即可。

接口开发第四步：接口测试

在接口开发过程中，您可以通过下图方式，让优采云服务器向您的接口发送一个标准的测试文章，以此来调试接口，您的接口如果有任何输出，都将在优采云这边实时显示。您也可以使用系统实际采集或生成一些文章，保存到暂存库，通过暂存库也可以进行单篇发布，以测试接口运行情况。

---

完毕，如有疑问，请咨询在线客服。