列表 |
简介 |
开发者协议 |
应用审核规范 |
开发流程 |
常见问题 |
名词解释 |
错误代码和含义 |
明道为企业提供了一个社会化沟通和协作的基本框架。在此平台上,有无限的应用扩展机会, 企业也需要围绕既有流程开发定制的应用工具。为此,明道一开始就将开放平台的理念植入产品设计。 基于明道开放平台,企业和第三方开发者均可设计和开发扩展应用。 第三方开发者通过加入明道应用市场可以获得强大的应用推广支持,快速获得客户和收入。
我们呼吁广大企业或者同行业者:保持开放的心态,紧紧围绕信息知识分享,加速内部沟通和实现高效协作的目标。
在明道开放平台上,我们为您提供了企业动态更新信息、 任务讨论、员工资料、群组、私信等一系列基于用户个人授权模式的数据读写接口, 广大的企业和第三方开发者只需登录此平台并申请创建应用, 即可通过授权令牌调用数据接口进行数据的读取与操作。
我们的目标是使您能够完全聚焦在自己的应用开发层面上, 也非常鼓励企业和第三方开发者依照明道平台的社会化沟通协作的特性, 开发出具有创新、解决企业迫切需求的应用。 另外,明道将和企业与第三方开发者共享在明道平台上的收益。
明道开放平台除了提供数据接口的开发文档, 同时还提供了必要的图标资源和SDK资源,目前我们提供了包括Java、 .Net/C#、 Php、 Ruby、 Python 等平台语言的SDK资源, 在未来一个阶段我们将继续完善其它主流开发语言的SDK资源,供广大开发者进行参考。 我们也非常鼓励开发者能够提供非官方的SDK资源,您可以点击这里与我们联系,我们将对提供有效SDK资源的开发者进行奖励。
明道应用开发类型: 现有应用增强:通过开放平台接口加强企业既有的IT系统, 使其能够和明道的用户、群组、动态更新等数据连接,给现有的企业应用提供社会化扩展。 定制开发扩展应用:基于开放平台为特定企业开发定制的扩展应用。应用可以被安装到明道平台内。 第三方应用:基于开放平台开发第三方应用,并加入明道应用市场,获得强大的应用推广支持,帮助您快速获得客户和收入。
此外,明道也提供了一套企业授权模式接口,它是指每家企业可以拥有一套独立的密钥信息(AppKey与SecretKey), 通过这套密钥信息来调用明道公布出来的企业相关的开放接口,比如审批、工作表的数据接口。 此套授权体系完全独立于个人用户授权的Open API体系,未来两套体系也会共存,它完全服务于企业相关的数据接口。 这套企业授权体系拥有较高的数据读取权限,目前此套密钥信息只有超级管理员可以进行查看管理,您可以在企业账户管理 - 设置 - 开发者选项 中进行管理,请务必妥善保管。
经过以上用户授权和应用授权流程之后,您就可以拿到访问令牌了,系统会输出如下格式的XML
<result> <access_token>令牌信息</access_token> <expires_in>用户访问令牌有效期(单位秒)</expires_in> <refresh_token>令牌刷新码</refresh_token> </result>
您可以在应用详情页的“API管理和申请”为应用申请敏感信息访问权限。请在内容中注明敏感信息的应用情景, 并留下您的电话号码以便我们可以及时的与您沟通,我们会进行评估,并与贵司签订保密协议后对数据进行开放。
2.命名、图标和描述
扩展应用应该有独立识别的命名,不能使用“项目管理”等中性名称。建议使用品牌+功能的组合,例如“微动社交管理”。 图标可自由设计,但不得和明道的系统内置图标雷同,包括明道官方开发的扩展应用图标。 应用应当提交一段简洁和直接的描述文字来介绍应用功能,并提供清晰可识别的截图。
3.接受的应用类型
明道应用市场只接受和工作有关联度的应用,不接受纯粹个人娱乐类应用。 不接受和明道本身定位雷同和冲突的应用。除此以外,提交的应用还需要满足以下条件: 通过明道的可用性测试,没有明显影响使用的bug,用户访问速度快; 应用解决的问题和命名与描述保持一致; 主要功能中不存在和明道基础应用重叠的模块,包括社交化动态更新,群组,任务和日程; 提供明确的客户支持联系信息; 提供明确的产品定价和购买信息; 在所有平台(包括Web和移动客户端等)支持明道账户登录; 应用不提供从明道平台复制用户内容性信息并在本应用中进行副本存储的功能 应用提交后,明道开放平台将在1-3个工作日内完成审核并通知结果。
网站接入:您只想在自己的网站实现“用明道账号登录”,无需在应用市场展示应用。
个人安装适用于: 每个账号在系统内都是独立存在的,两个账号之间不共享数据,没有协同特性的系统。
<?xml version=”1.0” encoding=”utf-8” ?> <result> <error_code>10001</error_code> </result>
{"error_code": "10001"}
错误代码 | 含义 |
10001 | 缺少参数 |
10002 | 参数所带值错误 |
10003 | 抱歉,您无权进行该操作 |
10004 | 抱歉,您无权查看该群组 |
10005 | 活捉一个bug:缺少返回参数,您可以提交到bug反馈中,或者您拨打客服电话:400-021-6464告诉我们,我们会尽快修复 |
10006 | 抱歉,您无权查看该任务 |
10007 | 抱歉,您查看的内容已删除 |
10008 | 抱歉,您无权查看该日程 |
10009 | 抱歉,任务已被锁定,您无法进行操作。您可以联系该任务负责人 |
10010 | 抱歉,您无权对该日程进行操作 |
10011 | 群组名称已存在,换个试试吧 |
10012 | 抱歉,您无权对该动态进行操作 |
10013 | 抱歉,您无权查看该动态 |
10014 | 抱歉,您无权查看该群组 |
10015 | 抱歉,您无权对该群组进行操作 |
10016 | 抱歉,您无权对该任务项目进行操作 |
10017 | 项目名称已存在,换个试试吧 |
10018 | 您需要网络管理员权限 |
10019 | 您需要系统广播员权限 |
10020 | 您需要网络管理员权限 |
10021 | 申请高级api接口后才能使用 |
10022 | 用户任务审批操作已执行 |
10023 | 不能对外联用户执行操作 |
10024 | 工作点不能重复新增 |
10025 | 此接口版本太低,请使用新版本的接口 |
错误代码 | 含义 |
10101 | 请求令牌不存在 |
10102 | 请求令牌签名不合法 |
10103 | 用户账号不存在 |
10104 | 密码错误 |
10105 | 用户访问令牌失效 |
10106 | 外联用户无法访问 |
10107 | 由于您的帐号尝试多次登录失败,已被锁定,请20分钟后再试 |
10108 | code已经失效 |
10109 | 您的账号存在异常,无法正常登录使用,请联系您的网络管理员 |
错误代码 | 含义 |
10201 | 邀请的Email格式错误,请重新填写 |
10202 | 该Email已注册 |
10203 | 你邀请的邮箱非本网络域名邮箱,只有高级模式的网络管理员才能邀请该类型邮箱用户 |
10204 | 非法邀请 |
10205 | 有效域名邮箱,不能通过来宾邀请加入 |
10206 | 无权限邀请来宾 |
10207 | 超出每天邀请数量 |
错误代码 | 含义 |
10301 | 暂无应用的最新版本 |
10302 | 抱歉,仅限企业应用可以使用 |
10303 | 抱歉,该功能仅限高级模式网络的管理员可以使用 |
10304 | 抱歉,该功能需要升级到高级模式 |
10305 | 抱歉,该功能仅限应用创建者可已使用 |
错误代码 | 含义 |
10401 | 该应该未安装 |
10402 | 扩展应用没权限直接通过用户账号获取令牌 |
10403 | 需要应用管理员权限 |
错误代码 | 含义 |
10501 | 免费网络没有权限发送 |
10502 | 当前用户没有权限发送 |
10503 | 当前用户本月手机短信数超出 |
10504 | 当前网络余额不足 |
10505 | 发送手机信息内容超出500字 |
10506 | 信息接受者没有手机号 |
10507 | 发送手机短信失败 |
错误代码 | 含义 |
1 | 操作成功 |
2 | 操作失败(当捕获不到预期异常均返回此值) |
2001 | 提交数据时参数缺失 |
2002 | 提交数据时参数值不对 |
2003 | 签名错误 |
2004 | 重复操作 |
2005 | 账户余额不足 |
2006 | 已经支付 |
2007 | 账单金额不正确 |
2008 | 出账应用不符合要求 |
2009 | 网络已卸载应用 |