开放平台

壹写作是一个开放的写作工具,不会涉及与版权,签约等其它平台常见行为,能够为所有的出版商提供一个免费的,专业的,标准化的写作工具,让您的用户能够随时,随时地开始创作,减免您平台创作部分的开发量

开发者流程

通过开发者流程,您将会获得您的平台如何处理壹写作的作者注册,登录,发布及更新作品的功能。一旦您的开发API通过审核,每个壹写作的作者都可以在出版模块找到您并添加为自己的出版商向您的平台输出作品。

准备按入

我们并未限制申请者的身份,无论是机构,企业还是独立开发者均可以按照自己的需求选择是否接入本平台。

  • 下载任一平台的壹写作客户端。下载

  • 注册成为 征稿 类型用户。

  • 在 我的账户>认证 中进行 实名认证

  • 在 我的账户>认证 中选择 申请出版商

  • 填写出版商信息及愿意接受的作品的类型,标准

  • 在 申请出版商 内一有选择项需要您提供 web服务地址。

    • web服务地址后跟上 /book 为作品投递地址

    • web服务地址后跟上/status 为作品状态查询地址

  • 用户接口方式分三类,您可视情况开通至少一种接口

    • 第三方账号绑定:弹出窗口在第三方网站登录或注册,完成回调后回调至壹写作。

    • 自动注册:自动注册用户至第三方网站,完成后直接发表

    • 软件内登录:在软件内通过用户名密码登录

  • 需要弹出第三方登录窗口的您针对《壹写作》的登录网址

  • 接收数据格式为文件的选择文件,接收数据格式为json的选择json数据格式

API开发

壹写作用户将向您的服务器POST如下数据并获得一些反馈。初次注册用户注册成功后您需要返回用户名与密码以利用户下次通过出版商账号进行作品发布,如果您无法通过此种方式返回用户名密码,请将信息发送至用户注册邮箱中以方便用户使用。所有第三方用户账号信息均保存在用户本机中,我们的 隐私与条款 保证了这些数据的安全使用。

1. 账号相关

平台可选择是通过第三方账号绑定或自动注册的方式与壹写作用户连接。第三方账号绑定将由出版商提供一个用于注册或登录的页面,壹写作在软件中弹出窗口供用户注册或登录第三方账号。自动注册则由壹写作直接推送用户信息至第三方账号完成绑定。出版商可自行选择账号边接策略。

1.1 第三方账号绑定

出版商提供一个特定的注册或登录页面给壹写作,壹写作用户在软件中打开此页面进行注册或登录,完成后获得相互通讯的token。

  1. 出版商需在设置中提供此链接,在申请出版商时即可提供。

  2. 壹写作用户在注册或登录完成后出版商需跳转至壹写作的回调页  http://appchina.1xiezuo.com/thirdapi/logincallback.php  并在参数中提供用户可用于账号登录的 openid与accesstoken

  3. 壹写作在收到该登录信息后将保存至服务器,下次用户可直接在文章发表中附上些身份信息进行验证

  4. 用户使用该 参数发表作品时无需再次认证

回调参数,附加在url中

字段 意义  备注 
 code 是否提交错误  必填 。 1为用户已经绑定 2为新增加绑定 3为找不到用户
openid  与您的用户表对应的用户id  必填
accesstoken  您的授权参数 必填
error 无code或为其它时显示错误 选填 。true 或false
error_message 错误原因 选填 。尽量30字符以内
appid 壹写作分配给第三方的appid 必填
timestamp 时间戳(php时间) 必填
signture 加密参数 必填,用于验证此请求是否来自壹写作合作方
uid 用户在壹写作的id 必填,由壹写作传递给第三方返回

1.2 自动注册或账号登录

在获得用户的许可后,壹写作将一些必选的公共信息(呢称,头像等),可选的邮箱信息推送给出版商,出版商可通过这些信息自动为用户注册新用户。如果平台允许,用户也可以直接通过出版商平台的老账户与壹写作的当前账户绑定。

POST web服务地址/user

POST参数

 参数 意义  备注 
usertype 用户登录类型 必填。auto为新用户注册;third为软件内第三方登录;bind为第三方弹窗登录
username 出版商用户账号 usertype为third时必填
password 出版商用户密码 usertype为third时必填
name  用户名称 u_usertype为auto时必填
nickname 用户笔名 u_usertype为auto时必填
picture 用户头像 u_usertype为auto时必填
description 用户描述 u_usertype为auto时必填
sex 用户性别 u_usertype为auto时必填
province 用户所有省份 选填
city 用户所有城市 选填
age 用户年龄 u_usertype为auto时必填
email 用户邮箱  用户选择对出版商开放邮箱时有效
openid  与您的用户表对应的用户id  已经授权的用户 选填
accesstoken  您的授权参数 已经授权的用户 选填
client_app 客户端参数  必填 ,固定  everywriter
client_uid 客户端参数 必填,用户在壹写作的id号
client_device 客户端参数  用户使用的客户端设置(如android,ios,windows等)

返回数据。返回数据仅接受json格式。

字段 意义  备注 
 code 是否提交错误  必填 。3为 找不到用户 1为找到用户 2为新注册用户
openid  与您的用户表对应的用户id  必填
accesstoken  您的授权参数 必填
usermessage 重要提醒用户注册登录信息 选填 。尽量30字符以内
bookmessage 重要提醒作品提交信息 选填 。尽量30字符以内
username 用户名称 选填。返回此用户名密码字段后用户下次将使用第三方账号出版作品
password 用户密码 选填。
sendmail  发送邮件 选填。布尔值。标明是否通过邮件发送了注册信息

 

2. 作品相关

在用户身份验证完成后,壹写作将作品的相关信息推送给出版商,出版商可根据作品信息对本地作品进行更新或新建。

POST web服务地址/book

POST参数

 参数 意义  备注 
updated 作品更新日期 必填。时间戳格式
booktype 作品类型 必填。如小说,剧本,电子书等
author 作品作者 必填。可能与作者呢称不同
booktitle 作品名称 必填
bid 作品唯一ID标识号 必填。可以通过此标识符与本地库对接
created 作品创建日期 必填。时间戳格式
updateDes 作者更新描述 必填。最长255字符
openid 作者在出版平台的用户id 必填。通过作者身份认证获得
booksize 作品长度 必填。
summary 作品简介 必有。字数不限
booktag 作品分类 必填。可通过本字段与您的本地库分类对接
bookstyle 作品风格 必填。可通过本字段与您的本地库分类对接
publishtype 作品发布状态 必填。full为全本;sub为连载中;signed为签约第三方
showall 作品内容完整性 必填。-1为全部章节,>0表示节选的章节数量
outlink  全本作品链接 选填。
outname 签约出版商名称 选填。
bookcover 作品封面图地址 选填。
datatype 作品数据类型 必填。包括 json与file
bookfile 作品文件地址 选填。当datatype为file时,必填,文件下载地址
content 作品内容 选填。当datatype为json时,必填,更新的作品内容

返回数据。返回数据仅接受json格式。

字段 意义  备注 
error 无code或为其它时显示错误 选填 。true 或false
error_message 错误原因 选填 。尽量30字符以内
bookurl 作品发布后的链接 选填 。尽量30字符以内
bookmessage 重要提醒作品提交信息 选填 。尽量30字符以内

在线测试

 无论在开发过程还是开发完成后,您都可以通过壹写作来测试您的API的合规性。测试成功后,您即可提交资格审核。

  • 已提交申请成为出版商

  • 通过壹写作新建一些作品

  • 在出版中选择您的出版商作为出版对象

  • 反复测试作品发布是滞符合您的需求

  • 测试功能无误后,请返回 我的账户>实名>出版商资料更新 将状态更新为 接口测试已经完成

资格审核

 资格审核必需满足如下要求。一经审核通过,会实时出现在出版商列表中。

  • 实名资料审核合格

  • 出版商资料审核合格

  • 出版商接口测试成功

  • 可阅读的出版商作品展示,包括web展示或App展示

注意事项

  • 如对出版商资料进行了更新,用户在发表文章时需要删除已绑定的该出版商并重新绑定