多彩网API专业提供国内外各类彩票开奖结果数据。主要面向彩票销售平台与第三方彩票数据分析机构等用户。免费提供准确、快速、稳定的开奖结果数据。用户可以通过简单的接口调用将开奖数据接入自己的平台（接口调用方法请参看接口说明），接口数据支持json、xml格式。

多彩网API分为免费版和收费版,需要首先进行简单的用户注册，凭注册账户调用API数据。

多彩网API(免费接口)开奖数据获取时间理论上与官方开奖结果发布延迟不超过2分钟。 在一个账户下，同一彩种，一分钟请求次数不能超过60次。

多彩网API极速版(付费接口)的开奖结果默认是理论提供零延迟，相对官方延迟1至5秒，体验极速，准确，稳定的奖源数据，但由于网络或其它技术原因，偶尔有可能对开奖时间产生数秒延迟。在一个账户下，同一彩种，一分钟请求次数不能超过60次

1 描述

根据相关参数，查询相关彩种信息。接口分为两个部分，分别是：1.查询接口，2.推送接口

2 查询接口

由客户访问我方提供的接口，获取自己想要的数据。

2.1 公共参数

请求地址

接口链接类型	请求地址
默认接口链接	http://free.jiangyuan365.com/< key值>/<彩票代码>-<返回行数>.<返回格式>
按期数的接口链接	http://free.jiangyuan365.com/< key值>/<彩票期数>/<彩票代码>.<返回格式>

公共请求参数

名称	类型	是否必须	描述
key 值	String	是	注册用户的唯一Key值
<彩票代码>	String	是	详见彩票列表
<返回格式>	String	是	返回的数据格式

返回的数据格式

Json

Xml

Html

2.2 请求参数

名称	类型	是否必须	描述
<返回行数>	Int	是	注册用户的唯一Key值
<彩票期数>	Int	接口链接类型必须为按期数的接口链接	期数格式详见彩票列表

2.3 响应参数

名称	类型	描述
issue	Int	彩票期数
opendate	Date	开奖时间
code	String	中奖号码
lotterycode	String	彩票代码

2.4 请求示例

2.5 响应示例

JSON

[
	{
	"issue": "20170314070",
	"opendate": "2017-03-14 17:40:00",
	"code": "2,1,8,6,5",
	"lotterycode": "CQSSC"
	}
]

XML

< xml >
	< item >
		< issue > 20170320086 < /issue >
		< opendate > 2017-03-20 20:20:00 < /opendate >
		< code > 1,5,9,0,8 < /code >
		< lotterycode > CQSSC < /lotterycode >
	< /item >
< /xml >

HTML

2.6 异常示例

JSON

{
	"status": false
	"error": "No users were found"
}

XML

< xml >
	< status >false< /status >
	< error >No users were found< /error >
< /xml >

HTML

2.7 错误代码解释

错误码	错误描述	解决方案
No users were found	未找到该用户	检查key是否正确
not found lottery	没有发现彩票	彩票代码没有填写正确
No data	没有数据	参数是否填写正确
Current user access denied	该用户不允许访问	重新生成key值

2.8 其他问题

（1）如何获取key值

（2）如何得知彩票代码

第一步：【登录】

第二步：登录成功后，点击右上角（注册时所填昵称），进入会员中心，即可查属于自己的key值

彩票代码

彩种名称	彩票代码	示例格式	奖期格式
欢乐生肖	CQSSC	20170424001	yyyymmdd[001-999]
福彩3D	FC3D	2017001	yyyy[001-999]
江苏快三	JSKS	170424001	yymmdd[001-999]
新疆时时彩	XJSSC	20170424001	yyyymmdd[001-999]
体彩P3	TCPL3	2017001	yyyy[001-999]
天津时时彩	TJSSC	201704241	yyyymmdd[1-99]
河南快3	HLK3	201704241	yyyymmdd[1-99]
河南481	HL481	1704241	yymmdd[1-99]
体彩排列5	TCPL5	2017001	yyyy[001-999]
上海时时乐	SHSSL	201704241	yyyymmdd[1-99]
广东11选5	GD11X5	170424001	yymmdd[001-999]
山东11选5	SD11X5	17042401	yymmdd[01-99]
江西11选5	JX11X5	20170424001	yyyymmdd[001-999]
上海11选5	SH11X5	201704241	yyyymmdd[1-99]
安徽11选5	AF11X5	1704241	yymmdd[1-99]
北京PK10	BJPK10	614216	614216
北京快乐8	BJKL8	819646	819646
瑞典1分彩	RD60	20170424-0001	yyyymmdd-[0001-9999]
泰国300秒	TG300	20170424-0001	yyyymmdd-[0001-9999]
泰国60秒	TG60	20170424-0001	yyyymmdd-[0001-9999]
金边五分彩	JBWFC	20170424-0001	yyyymmdd-[0001-9999]
金边分分彩	JBFFC	20170424-0001	yyyymmdd-[0001-9999]
印尼五分彩	YN300	20170424-0001	yyyymmdd-[0001-9999]
西贡五分彩	XG300	20170424-0001	yyyymmdd-[0001-9999]
印尼分分彩	YN60	20170424-0001	yyyymmdd-[0001-9999]
西贡分分彩	XG60	20170424-0001	yyyymmdd-[0001-9999]
瑞典2分彩	RD120	20170424-001	yyyymmdd-[001-999]
河内五分彩	HN300	20170424-0001	yyyymmdd-[0001-9999]
河内分分彩	HN60	20170424-0001	yyyymmdd-[0001-9999]
日本分分彩	RB60	20170424-0001	yyyymmdd-[0001-9999]
腾讯分分彩	TXFFC	20170808-0001	yyyymmdd-[0001-9999]
QQ分分彩	QQFFC	20170808-0001	yyyymmdd-[0001-9999]
四川快乐12	SCKL12	170808001	yymmdd[001-999]
台湾五分彩	TW300	106044571	106044571
江苏11选5	JS11-5	2017090101	yyyymmdd[01-99]
重庆幸运农场	CQXYNC	2017090101	yyyymmdd[01-99]
云南时时彩	YNASSC	2017090101	yyyymmdd[01-99]
广东快乐十分	GDKL10	20170901001	yyyymmdd[001-999]
湖北快3	HBK3	20170901001	yyyymmdd[001-999]
辽宁11选5	LN11-5	170901001	yymmdd[001-999]
广西11选5	GX11-5	17090101	yymmdd[01-99]
安徽快三	AHK3	2017090101	yyyymmdd[01-99]
吉林快三	JLK3	2017090101	yyyymmdd[01-99]
黑龙江11选5	HLJ11X5	1804241	yymmdd[1-99]
泰国11选5	TG11X5	20180424-0001	yyyymmdd-[0001-9999]
云南11选5	YN11X5	20180424001	yymmdd[001-999]
广西快3	GXKS	2018042301	yyyymmdd[1-99]
天津快乐十分	TJKL10	20180424001	yyyymmdd[001-999]
湖北11选5	HB11X5	2018042401	yyyymmdd[1-99]
香港六合彩	XGLHC	18/042	yy/zzz+1
香港PK10	XGPK10	20180424-001	yyyymmdd-[001-999]
幸运飞艇	XYFT	20180423001	yyyymmdd[1-99]
广西快乐十分	GXKL10	201810701	yy/zzz+1[01-50]
重庆时时彩30秒	CQSSC30S	20180424-0001	yyyymmdd-[0001-9999]
腾讯分分彩30秒	TXFFC30S	20180424-0001	yyyymmdd-[0001-9999]

3 推送接口

3.1 API接口请求参数

请求参数	参数名称	参数类型	是否必填	描述
key	密钥	string	是	usercode按规则加密码后的密文
type	操作类型	string	是	增加（insert）
				删除（delete）
				修改（update）
lotteryid	奖源ID	int	是
issue	奖期号	int	是
code	开奖号码	sring	是
old_code	修改前开奖号码	string	否	修改操作时具有的参数

3.2 API返回参数

返回参数	参数名称	参数类型	示例
results	成功结果	string	ok(必须为小写)
errno	失败结果	string

3.3 密钥算法

密钥=md5(sha1(奖期号. 奖源ID.开奖号码.用户注册唯一识别码));

3.4 API推送流程

3.5 流程详解

第一步：提供API接口url，接收请求参数(接口提供位置：个人中心，选择【自动推送彩票开奖结果】，在输入链接处，输入url，点击【保存】后，就可正常接收推送信息。

第二步：验证key密钥是否正确

第三步：第二步执行成功后，根据请求参数，对该条数据进行逻辑处理

第四步：根据第三步操作结果，返回操作状态

第五步：如果第二步或第三步执行失败，则需要返回错误信息（返回参数除了ok以外，都为失败）。

3.6 注意事项

若某彩种连续30期推送失败系统将自动冻结该彩种推送，需要联系客服重新开启

3.7 API 接口 demo.rar

彩票名称	规则说明
腾讯分分彩	腾讯分分彩最初是根据腾讯平台的在线人数所产生的彩种，经过市场的不断演变后，目前市面存在的奖源数据也不尽相同，多彩网主要以奖源接口合作方式获取腾讯官方平台实时统计的数据源，作为每一期的开奖号码，开奖规则如下： 1、万位数：依照官方实时统计的在线人数数字的总和，再取尾数； （例如：线上人数266106016人，则为2+6+6+1+0+6+0+1+6=28，取尾数8，因此万位数为8） 2、后四码：依照官方实时统计的在线人数，取末四位为千百十个这4个号码； （例如：线上人数266106016人，则末4码为6016） 由于各平台统计期数不同，多彩网开奖期数如下： 腾讯分分彩开奖期数为：年月日-当日开奖次数 比如：2017年8月11日00点01分为当日第一期开奖，即为20170811-0001； 比如：2017年8月11日00点00分为当日最后一期开奖，即为20170811-1440。 以上规则望用户周知，有关每期开奖结果，用户可通历史开奖查看，以实际查看结果为准。
QQ分分彩	QQ分分彩最初是根据QQ的在线人数所产生的彩种，经过市场的不断演变后，目前市面存在的奖源数据也不尽相同，多彩网主要以奖源接口合作方式获取腾讯官方平台QQ当前在线实时统计的数据源，作为每一期的开奖号码，开奖规则如下： 1、万位数：依照官方实时统计QQ的在线人数数字的总和，再取尾数； （例如：线上人数225684547人，则为2+2+5+6+8+4+5+4+7=43，取尾数3，因此万位数为3） 2、后四码：依照官方实时统计QQ的在线人数，取末四位为千百十个这4个号码； （例如：线上人数225684547人，则末4码为4547） 由于各平台统计期数不同，多彩网开奖期数如下： QQ分分彩开奖期数为：年月日-当日开奖次数 比如：2017年8月11日00点01分为当日第一期开奖，即为20170811-0001； 比如：2017年8月11日00点00分为当日最后一期开奖，即为20170811-1440。 以上规则望用户周知，有关每期开奖结果，用户可通历史开奖查看，以实际查看结果为准。
腾讯PK10	腾讯PK10最初是根据腾讯的在线人数所产生的彩种，经过市场的不断演变后，目前市面存在的奖源数据也不尽相同，多彩网主要以奖源接口合作方式获取腾讯官方平台腾讯当前在线实时统计的数据源，每一期的开奖号码规则如下： 腾讯「当期在线人数」加上「当期统计时间」加上「在线人数总和」， 使用SHA512哈希算法执行哈希取得哈希值后，依据最先出现的阿拉伯数字做为赛车结果（重复值跳过），0代表10号车。 范例：当期统计时间 2019-03-15 11:19:00 当期在线人数 307658584 在线人数总和 3+0+7+6+5+8+5+8+4=46 SHA512哈希取值： 当期在线人数+当期统计时间+在线人数总和 => 3224465812019-03-06 21:58:0035 =>f0d2f868632979aace28b487897d2eacfb79a452f7bc19e304b55b87f647843461718966a57e004304 511a9ad4f5949d6cc87348e61ce329824bdad1e92b80b9 =>10,2,8,6,3,9,7,4,5,1 由于各平台统计期数不同，多彩网开奖期数如下： 腾讯分分彩开奖期数为：年月日-当日开奖次数 比如：2017年8月11日00点01分为当日第一期开奖，即为20170811-0001； 比如：2017年8月11日00点00分为当日最后一期开奖，即为20170811-1440。 以上规则望用户周知，有关每期开奖结果，用户可通历史开奖查看，以实际查看结果为准。
柚子分分彩	1）开奖时间：00:00~24:00 2）开奖频率：每分钟开奖一次，一天开奖1440期 （开奖前5秒封单） 3）奖期格式：年月日-四位序列号（如20190212-0001） 4）号码来源：https://bloks.io/live 5）开奖号码：柚子分分彩开奖号码从每分钟起始依次取连续的5个EOS的区块号的最后一位数字作为开奖号码的万、千、百、十、个位。当区块号最后一位不是数字时，依次向前找到最近的数字代替。

多彩网服务协议

多彩网是一家专业从事彩票API接口开发的公司，致力为用户提供准确、快速、稳定的彩票API接口服务（以下简称：本服务），所以，在使用本服务之前，请您仔细阅读并遵守《多彩网服务协议》（以下简称：本协议）以及协议里所附带的《多彩网产品说明文档》、《多彩网彩票接口输出格式规范》。 请务必阅读并充分理解各条款内容，尤其是关于免责声明或者责任限制的条款协议、规则内容。 除非您已阅读并接受本协议及相关协议、规则等所有条款，否则，您无权使用多彩网提供的本服务。若您使用本服务，即视为您已阅读并同意本协议所包括之所有内容，您将受到本协议的约束。若您违反本协议中的任何条款，则多彩网有权依照违反情况，在无任何通知的情况下，随时单方面终止向您提供本服务，并有权追究您的相关责任。

1、术语含义

1.1 多彩网：彩票API接口开发的公司，向第三方开发者开放彩票数据、历史开奖等与彩票相关API接口的平台；

1.2 您：指单个的您或您所代表的公司、组织、团体等（以下简称“您”）；

1.3 API接口： API （Application Programming Interface，应用程序编程接口） 提供给第三方用于实现某一特定功能的接口，在本协议中指彩票API接口；

1.4 商业秘密：指与API接口所涉及到包括但不限于技术代码、技术方式、技术接口实现、开奖参考依据等与之相关的技术范畴。

2、授权及权利保留

2.1 您在被授权通过PC、移动端使用API许可的前提是：您完全同意并遵守本协议所包括之所有内容。另外：您知悉并同意本协议仅允许您可以按照本协议使用API，而且不允许出售；并且此许可是非排他性的、非独占性的、不可转让的，并且多彩网有权随时收回本许可。

2.2 您在成功成为会员后，可以使用唯一的Key值自行决定选择任意彩票种类来生成、使用API，并经后可申请多彩网为您提供服务，包括但不限于免费、收费服务。Key值为用户接口API重要程序，请在此过程保证为您使用，任何人做出的使用您个人Key值的行为都将视为属于您的行为，您需要自行对此负责。

2.3 在此未明示的授权均由多彩网保留，官方有权在无通知的情况下修订、增减授权及权利内容。

3、使用说明

您对API的使用不得侵犯任何人的知识产权或其他合法权益，包括但不限于多彩网的商标、商业秘密、logo、商业标识等或任何第三方的任何权益。

多彩网服务是以免费方式提供，您理解并同意：多彩网会根据实际需要对本平台上的部分服务开始收费，开始收费前，多彩网将在相应服务页面进行通知或公告。如果您不同意与之相关的付费内容，则应停止使用该服务。

服务变更：您理解并同意多彩网有权添加、删除、修改、变更或终止您在本服务使用中或使用过后所涉及到的部分或全部内容，包括但不限于免费或付费的内容。

4、所有权和知识产权

本服务及一切相关的知识产权、所有权等权利都属于多彩网所有，在未事先获得多彩网书面同意的情况下，你不应：

（a）复制、租赁、出售、转让、分配、再授权、分解、逆向工程或反编译、修改或变更API；

（b）以虚假身份或第三方身份使用API;

（c）出售或以其他方式利用API获利；

（d）行使其他损害多彩网利益的行为。

5、品牌

在未经多彩网事先商务书面同意的情况下，您承诺不得进行删除、隐藏或破坏、变形、修改多彩网的任何品牌图标。您也不得以除了本协议允许外的任何其他方式使用多彩网的任何商标、标志、logo。您在您的应用里使用多彩网任何与之相关的标志时，请确认要明显的表明所涉及的标志属于多彩网所有，且不能给予用户任何多彩网为您的应用代理或您在为多彩网代理或您和多彩网具有合作关系或类似关系的暗示。

6、支持和升级

虽然多彩网致力于给用户提供最好的彩票技术支持，且尽管有本协议的签订，多彩网也并不保证也不承诺您可以得到任何经调试、升级和定制的API，除非您单独与多彩网有特定、特有的其他书面约定。多彩网可根据具体情况，在不进行任何警告、也无需得到您同意的前提下，自行决定是否无条件终止这些条款和您继续使用本服务的权利。

7、免责声明

您理解并同意，多彩网仅按现有的及可能包含瑕疵的API接口内容提供给您，并不承担任何形式的保证、担保和保修责任。多彩网在此明确排除所有一切明示或暗示的，口头或书面的关于对API接口的保证，包括但不限于API接口的完整性、准确性、非侵权、适销性、设计操作通用性等。多彩网及其商务代理人、员工都无权提供任何口头或书面建议从而导致此明确规定的保证排除的修改。除非另有明确规定，多彩网不保证该API接口符合您的所有要求，或该API接口的运行不会中断或没有错误，或者说所有的API接口缺陷都将得到多彩网的纠正。

此外，如因您使用了本服务或多彩网的品牌标志等内容、信息而造成您的损失的，多彩网不承担任何责任，包括但不限于下述任意情况导致您损失的：（a）非经多彩网授权而修改、误用和损害API接口编程；（b）您未能正确实施多彩网提供的针对本服务的错误修复；（c）您未按照多彩网提供的技术文档及本文档约定下正确使用本服务的；（d）任何电脑病毒、黑客等；（e）任何您或第三方的个人计算机、设备、网络或软件故障，您或任何用户本身的错误所造成的损失；（f）因使用本服务或多彩网任何标志、数据信息所引起的任何纠纷。

多彩网所开放的彩票开奖结果，理论上与官方保持同步、期数一致，但是，不排除与官方数据存在包括但不限于期数差异、时间延迟（则同期开奖时间比官方延迟5至10分钟内）、纠正重排等，此类之现象均视为数据可接受的误差之现象，您在使用的过程中无权就此对多彩网做出任何追责行为，包括担不限于商业追责、法律追责、索赔、经济损失追讨等，因此而造成您的任何损失均与多彩网无关。

您同意多彩网将不会承担任何因使用本服务或多彩网标志而导致的一切责任，您应当自己承担因使用本服务或多彩网标志而产生的任何及所有索赔、损害、责任及所产生的成本和费用（包括但不限于律师费）并确保多彩网能避免因此遭受损失、影响。

8、责任限制

在任何情况下，即使被提前告知可能性，多彩网对您的任何损失不承担任何责任，此类损失包括但不限于数据或其他个人或商业信息丢失和损坏、经济、利润损失；因使用本服务所导致的任何特殊的、偶然的、直接或间接的损失等。即使多彩网知道或应该知道可能的后果，此责任限制仍然适用。

9、高风险活动排除

多彩网的API设计的可靠性或适用性并不能保证其在对安全性能要求很高的领域中的使用，这类领域包括但不限于核设施、飞机导航或通讯系统、空中交通控制、武器系统的等应用（统称“高风险活动”）。多彩网对将API运用于以上高风险活动不承担任何责任。

10、隐私

在使用多彩网的API时可能会要求您提供个人识别信息，包括但不限于您的姓名、联系电话、公司名称、公司网址、电子邮件地址等。除非得到您的授权，或者被要求依法律、法规披露或在诉讼等资料中必须披露，多彩网不会分享或对任何第三方披露信息。 您认可并同意多彩网为了提高本服务平台的可用性和质量的目的而分析您使用API的情况。这时，多彩网可能会记录和访问您部分使用信息和数据。

11、期限和终止

本协议对您生效的起始日期是您成为会员后首次使用Key值生成个人独有的彩票彩种链接接入您的平台开始。此条款终止条件包括但不限于：任何时候您不遵守本协议中的任何条款内容；或您彻底停止使用此API；或多彩网单方终止这些条款或终止服务；或多彩网收回您访问API的权利。

此条款一旦以任何形式终止，您的所有许可和其他相关权利将会立即终止。

12、修改

多彩网有权在任何时间自行决定修改、增减本服务协议的有关内容并公布在官方网站上。若您继续使用多彩网提供的该服务即表明您同意多彩网做出的修改并严格遵守，若您不同意多彩网的修改，您必须立即停止使用多彩网提供的服务或者API相关技术、接口。

13、联系

基于API接口的过程所遇到或存在的任何问题，您可以随时邮件联系我们，我们的工作人员将会第一时间与您联系解决，邮箱地址： cs@jiangyuan365.com

14、附件

附件一：《多彩网产品说明文档》

附件二：《多彩网彩票接口输出格式规范》

多彩网

2017-6-7