开发者流程

简介

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

准备按入

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

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

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

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

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

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

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

  • 有 web服务地址 提供事务处理代码

API开发

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


1. 账号相关

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

POST web服务地址/user

POST参数

 参数 意义  备注 
usertype 用户登录类型 必填。auto为新用户注册;third为出版商账号登录
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 作品封面图地址 选填。
bookfile 作品文件地址 必填。文件下载地址



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


字段 意义  备注 
bookmessage 重要提醒作品提交信息 选填 。尽量30字符以内

在线测试

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

  • 已提交申请成为出版商

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

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

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

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

资格审核

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

  • 实名资料审核合格

  • 出版商资料审核合格

  • 出版商接口测试成功

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