欢迎光临矩形树图制造厂

如何使用树形图API

1、登录树形图制造厂网站（http://treemap.me);

2、注册成为开发者，获得APPID;

3、参考技术文档和Demo编写代码。

接入方式

树形图API通过HTTP接口提供树形图生产服务。您只需要调用树形图API，传入待生成的内容，就可以得到相应的树形图返回结果。

树形图API HTTP地址：

http://treemap.me/api/treat_data

输入参数:

字段名	类型	必填参数	描述	备注
width	TEXT	Y	树形图总宽度	数值转成字符，比如“1000”
height	TEXT	Y	树形图总高度	数值转成字符，比如“500”
sites	TEXT	Y	树形图内各数据项列表
app_id	TEXT	Y	APPID	可在“个人中心”查看
sign	TEXT	Y	签名	appid+salt+secretkey后，编码成UTF-8，之后再MD5的值
salt	TEXT	Y	随机数	请先转为字符，再使用

上表中sites列表中每一项的内容:

字段名	类型	必填参数	描述	备注
name	TEXT	Y	数据项名称	两个数据项的名称可相同，但不建议这么做（会减低可读性，返回的数值也不好进一步处理）。建议填写数据项ID
pos	TEXT	N	数据项在树形图中的位置	为返回参数，调用的时候可填写[0,0]列表
w	TEXT	N	数据项在树形图中的宽度	为返回参数，调用的时候可填写“0”。
h	TEXT	N	数据项在树形图中的高度	为返回参数，调用的时候可填写“0”。
size	TEXT	Y	数据项数值大小	必填，整数值，如“32965”

请求方式：可使用POST方式,Content-Type请指定为content_type="application/json,charset=utf-8"

字符编码：统一使用UTF-8编码格式

签名生成方法：签名是为了保证调用安全，使用MD5算法生成的一段字符串。

具体生成方法为：

Step1：将请求参数中的APPID（appid），随机数（salt），以及平台分配的密钥（secret key），按

appid+salt+secret_key的顺序拼接得到字符串1

Step2：将字符串1转码为UTF-8格式编码得到字符串2

Step3：对字符串2做MD5，得到32位小写的sign。

错误码列表

当树形图结果无法正常返回时，返回参数“error”，该参数的返回值参考下表：

错误码	含义	解决方法
52001	"Invalid app_id/secret_key,please try again"“提供了错误的APP_ID/Secret_key组合，无法进行服务”	提供签名的时候请提供正确的APP_ID，Secret_key
52002	"CreditPoint used off，please recharge."“信用额度用完，请联系管理员添加信用额度”	您获得的初始信用额度/购买的附加信用额度都已用完，请联系管理员获得新的信用额度

Python (点击下载)