开放平台
壹写作是定位写作工具类的应用,类似于Evernote,Word等写作工具,所不同的是我们的所有功能设计都以长文写作为本,例如小说,剧本,电子书,生活积累等,我们所有的模块设计均聚焦于让作者写出更好的作品,更好地管理作品的生命周期。
壹写作是一个开放的写作工具,不会涉及与版权,签约等其它平台常见行为,能够为所有的出版商提供一个免费的,专业的,标准化的写作工具,让您的用户能够随时,随时地开始创作,减免您平台创作部分的开发量,专心于平台运营。壹写作本身并不运营版权平台,壹写作致力于为写作者提供最优的工具与最简洁的出版流程,开放平台能够帮助写作者获得更多眼球,也能够为出版商提供更多的用户,作品与工具,与出版商一起实现合作双赢。
壹写作开放平台提供了一个极简API接口让您方便快捷地能够使用壹写作作为您的应用的专业级的写作工具,并获得壹写作的用户,作品。您只需要让技术人员按照 开发者流程 完成技术接入工作【约1-3个工作日】,即可享受来自壹写作的洪荒之力:)。
壹写作经过一年多的封闭式运营后已经获得了一个用户活跃的广受好评的4.X稳定产品,拥有包括五个平台、四种语言的APP与PC、MAC客户端,我们的英文版本被国外用户美誉为 It's a great tool for all lever of authors ,国内用户更戏称它为 写作入门者的装B利器 ,港台繁体创作领域也一片欣欣向荣,接入我们的API,我们可以向您提供如下独一无二的服务。
一款专业的写作工具。让您的用户可以通过PC,MAC,ANDROID,IOS,WINDOWS 10等主流桌面与移动端实时更新他的作品,这些客户端具有一致性的全功能,功能便利到N多9,10岁的小学生也能够通过平台输出结构化的作品。而且,我们仍旧在工具创新的道路上日新月异。
一批实时更新的作品。这些作品通过了我们的编辑初审,减免了您审核作品的工作,最重要的是这些作品具有作者定义的完整版权,可以随时与您的平台签约,而且即使签约其它平台,仍旧可以向您的平台提供作品的一个展示。
一群活跃度高的作者。我们将基于作者意愿无偿分享我们的作者资源,让他们可以通过接口成为您的应用的一员,我们具有一批年龄分布面向未来,写作历练倾向前期,创作热情高,移动写作热情高的创作人群。而他们,正是文学的未来。
一些您未曾见的新文体。我们标准化的输出作品格式已经能够解析除小说外的剧本,聊小说等新文体,我们已经负责将这些新文体的创作难度减小到最低,而您接入这些新文体可以让您的应用更具视觉冲击力。
一个高质量的广告位。一旦您申请成功,您即成为作者们作品变现的一个渠道,我们会在出版商列表中提供您的广告位获得所有作者的关注与运用。
长文写作工具已经多年未有突破,即使有些写作工具偶有灵光也基本是为自家的写作平台设计。而壹写作创始第一个灵感即是生为生态。我们希望为所有的电子出版商提供一个最靠近作者的中间件。我们仍未发现值得有值得您尝试的竞品,所以,出版商们(包括文学平台,阅读APP,影视APP,自媒体出版者及传统出版者)都可以使用此服务,以下出版商更值得一试为先。
移动阅读平台。您也许希望获得一些新的作者资源?也许希望获得一些新的作品资源?也许希望接入一些新文体?也许希望能够拓展您的用户能够通过移动应用提交作品的能力?我们能够满足以上的所有。
影视剧本平台。传统的剧本格式大多是由txt,word或html这些为所有人设计的开发工具编写,不但阅读难度大,大数据化也是困难重重,现在,我们为您提供了新的剧本解析格式,只需一个接口,您即可以获得大量剧本并藉此建立自己的数据化剧本生产平台。
传统媒体。无论是自媒体杂志,小说出版物,电台,电视台,您都可以个性化地定制您的需求让海量用户为您输送来自互联网的新鲜想法。
您需要技术人员花一些时间对接收到的数据进行解析并与您自己的数据系统进行整合以便用您的方式展示给您的读者,这些后台技术并不复杂,我们也为您提供了一些解析的案例,您可以让技术人员按照案例的要求进行开发与测试。
点击这儿下载了解 壹写作开放平台开发者流程,点击这儿下载 示例代码。
在传统的网络技术下形成的阅读平台的格局必将在新领域,新技术,新带宽的带动下不断革新,语音写作,直播式写作都有可能出现,我们希望能够在写作领域内为出版商提供一个引领性的工具,除了目前提供的 开放平台API 外,也在积极尝试以下的新的合作模式。
出版商专用写作工具。我们以目前工具为背景,为您的平台提供一个专用的写作工具,让您的用户轻松地投递与管理他的作品。
出版商知识管理平台。无论是出版商还是影视公司,他们都可以通过壹写作构架的生态模块将作品的生命周期有效的管理与运用起来,稳步迈向行业+。
SDK开发工具。我们提供一套跨平台的SDK开发工具,让其它阅读平台或拥有一定用户量的应用能够在自已的软件框架内通过SDK获得写作功能与作品运营功能。
通过开发者流程,您将会获得您的平台如何处理壹写作的作者注册,登录,发布及更新作品的功能。一旦您的开发API通过审核,每个壹写作的作者都可以在出版模块找到您并添加为自己的出版商向您的平台输出作品。
我们并未限制申请者的身份,无论是机构,企业还是独立开发者均可以按照自己的需求选择是否接入本平台。
下载任一平台的壹写作客户端。下载
注册成为 征稿 类型用户。
在 我的账户>认证 中进行 实名认证
在 我的账户>认证 中选择 申请出版商
填写出版商信息及愿意接受的作品的类型,标准
在 申请出版商 内一有选择项需要您提供 web服务地址。
web服务地址后跟上 /book 为作品投递地址
web服务地址后跟上/status 为作品状态查询地址
用户接口方式分三类,您可视情况开通至少一种接口
第三方账号绑定:弹出窗口在第三方网站登录或注册,完成回调后回调至壹写作。
自动注册:自动注册用户至第三方网站,完成后直接发表
软件内登录:在软件内通过用户名密码登录
需要弹出第三方登录窗口的您针对《壹写作》的登录网址
接收数据格式为文件的选择文件,接收数据格式为json的选择json数据格式
壹写作用户将向您的服务器POST如下数据并获得一些反馈。初次注册用户注册成功后您需要返回用户名与密码以利用户下次通过出版商账号进行作品发布,如果您无法通过此种方式返回用户名密码,请将信息发送至用户注册邮箱中以方便用户使用。所有第三方用户账号信息均保存在用户本机中,我们的 隐私与条款 保证了这些数据的安全使用。
1. 账号相关
平台可选择是通过第三方账号绑定或自动注册的方式与壹写作用户连接。第三方账号绑定将由出版商提供一个用于注册或登录的页面,壹写作在软件中弹出窗口供用户注册或登录第三方账号。自动注册则由壹写作直接推送用户信息至第三方账号完成绑定。出版商可自行选择账号边接策略。
1.1 第三方账号绑定
出版商提供一个特定的注册或登录页面给壹写作,壹写作用户在软件中打开此页面进行注册或登录,完成后获得相互通讯的token。
出版商需在设置中提供此链接,在申请出版商时即可提供。
壹写作用户在注册或登录完成后出版商需跳转至壹写作的回调页 http://appchina.1xiezuo.com/thirdapi/logincallback.php 并在参数中提供用户可用于账号登录的 openid与accesstoken
壹写作在收到该登录信息后将保存至服务器,下次用户可直接在文章发表中附上些身份信息进行验证
用户使用该 参数发表作品时无需再次认证
回调参数,附加在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展示
如对出版商资料进行了更新,用户在发表文章时需要删除已绑定的该出版商并重新绑定
您可以通过此邮件沟通并了解业务合作事宜。 邮箱:rain.ful#gmail.com
您可以通过此微信群了解开放平台接入技术相关事宜,您可以通过此微信号获得加入微信群的邀请,请在验证时前注明您的身份。 微信号: rainfuling