API概念

  API(Application Programming Interface,应用程序编程接口)是一些预先定义的函数,目的是提供应用程序与开发人员基于某软件或硬件得以访问一组例程的能力,而又无需访问源码,或理解内部工作机制的细节。

  应用程序接口(API:application programming interface)是一组定义、程序及协议的集合,通过 API 接口实现计算机软件之间的相互通信。API 的一个主要功能是提供通用功能集。程序员通过使用 API 函数开发应用程序,从而可以避免编写无用程序,以减轻编程任务。


目录概览

  • 1.接口参数说明

  • 2.数据码表接口

  • 3.房地产数据接口

  • 4.天气数据接口

  • 5.股票数据接口

  • 6.用户注册接口


1.接口参数说明

API接口域名网址:

    http://api.galaxystatistics.com

端口号:

    8889        # 不同的接口,会使用不同的端口号(如:8887、8888等)

我相信程序员都是有节操的,不会恶意使用这个Key!

    公共测试 ApiKey(token=xxxxxx): 098f6bcd4621d373cade4e832627b4f6

数据类型:

    type=41     # 不同类型的数据接口,采用不同的type值

变量名:

    var_name=DataCode       # 根据程序需求,自定义变量名称

检索条件,举例:

    city_code=1101,1201,1301        # 城市编码集合
    start_time=2011.01              # 条件开始时间
    end_time=2016.12                # 条件结束时间
    mark=1                          # 标识编号

字段名称解释:

    en_names        # 英文名称
    ch_names        # 汉文名称

2.数据码表接口

(2.1) 国标省码表数据

URL:http://data.galaxystatistics.com:8889/?token=xxxxxx&type=41&var_name=DataCode

en_names = = ['province_code','province_name1','province_name2']

ch_names = ['省码表','省名称1','省名称2']

(2.2) 国标城市码表数据

URL:http://data.galaxystatistics.com:8889/?token=xxxxxx&type=42&var_name=DataCode

en_names = ['city_code','city_name1','city_name2','province_code','province_name']

ch_names = ['城市码表','城市名称1','城市名称2','省码表','省名称']

(2.3) 国标行政区码表数据

URL:http://data.galaxystatistics.com:8889/?token=xxxxxx&type=43&var_name=DataCode

en_names = ['district_code','district_name1','district_name2','province_code','province_name','city_code','city_name']

ch_names = ['行政区码表','行政区名称1','行政区名称2','省码表','省名称','城市码表','城市名称']

(2.4) 国家统计局70城市码表数据

URL:http://data.galaxystatistics.com:8889/?token=xxxxxx&type=44&var_name=DataCode

en_names = ['city_code','city_name1','city_name2']

ch_names = ['城市码表','城市名称1','城市名称2']

(2.5) 搜房百城指数城市码表数据

URL:http://data.galaxystatistics.com:8889/?token=xxxxxx&type=45&var_name=DataCode

en_names = ['city_name','city_code','district_code']

ch_names = ['城市名称','城市码表','行政区码表']

(2.6) 百度省码表数据

URL:http://data.galaxystatistics.com:8889/?token=xxxxxx&type=46&var_name=DataCode

en_names = ['province_code','province_name','longitude','latitude']

ch_names = ['省码表','省名称','经度','纬度']

(2.7) 百度城市码表数据

URL:http://data.galaxystatistics.com:8889/?token=xxxxxx&type=47&var_name=DataCode

en_names = ['province_code','city_code','province_name','city_name','longitude','latitude']

ch_names = ['省码表','城市码表','省名称','城市名称','经度','纬度']

(2.8) 环保局城市码表数据

URL:http://data.galaxystatistics.com:8889/?token=xxxxxx&type=48&var_name=DataCode

en_names = ['py_city_name','city_name','city_code','district_code']

ch_names = ['城市名称(拼音)','城市名称','城市码表','行政区码表']

3.房地产数据接口

(3.1) 获取国家统计局70城市指数数据

URL:http://data.galaxystatistics.com:8888/?token=xxxxxx&type=11&var_name=oIndex&city_code=1101,1201,1301&start_time=2011.01&end_time=2016.12&mark=1

en_names = ['city_code','city_name','chainid','anid','fixedid','timeseries']

ch_names = ['城市码表','城市名称','同比','环比','定基','日期']

# 标识解释
    chainid    环比
    anid       同比
    fixedid    定基
    mark=1     新建住宅价格指数
    mark=2     新建商品住宅价格指数
    mark=3     二手住宅价格指数

(3.2) 获取国家统计局70城市(以2010年和2015年为定基)修正指数数据

URL:http://data.galaxystatistics.com:8888/?token=xxxxxx&type=12&var_name=oPrice&city_code=1101,1201,1301&start_time=2011.01&end_time=2016.12&mark=1

en_names = ['city_code','city_name','chainid','anid','fixedid','fixed10','fixed15','fixed_prcie10','fixed_prcie15','timeseries']

ch_names = ['城市码表','城市名称','同比','环比','定基','2010年修正定基','2015年修正定基','2010年修正定基换算价格','2015年修正定基换算价格','日期']

(3.3) 获取搜房百城指数数据

URL:http://data.galaxystatistics.com:8888/?token=xxxxxx&type=13&var_name=oPrice&city_code=1101,1201,1301&start_time=2015.01&end_time=2016.12

en_names = ['city_code','city_name','price','timeseries']

ch_names = ['城市码表','城市名称','价格','日期']

6.用户注册接口

(6.1) 用户注册

URL:http://data.galaxystatistics.com:8887/?token=&type=51&var_name=oAdmin&admin_id=test&admin_name=abdata&admin_password=test&admin_md5=098f6bcd4621d373cade4e832627b4f6

    # 参数说明
    admin_id                # 用户id,唯一
    admin_name              # 用户名称
    admin_password          # 用户密码
    admin_md5               # MD5(admin_id+admin_password)

(6.2) 用户注册表查看

URL:http://data.galaxystatistics.com:8887/?token=&type=53&var_name=oAdmin

7.答题(插入|检索|删除)

(7.1) 插入

http://data.galaxystatistics.com:8886/?token=098f6bcd4621d373cade4e832627b4f6&type=61&var_name=oAdmin&data_name=vba1&answer_str=aaaaaaaaaaaaaa

http://data.galaxystatistics.com:8886/?token=098f6bcd4621d373cade4e832627b4f6&type=61&var_name=oAdmin&data_name=vba2&answer_str=bbbbbbbbbbbbbb

(7.2) 检索

http://data.galaxystatistics.com:8886/?token=098f6bcd4621d373cade4e832627b4f6&type=62&var_name=oAdmin&data_name=vba1

(7.3) 删除

http://data.galaxystatistics.com:8886/?token=098f6bcd4621d373cade4e832627b4f6&type=63&var_name=oAdmin&data_name=vba1


### 举例

http://data.galaxystatistics.com:8887/?token=098f6bcd4621d373cade4e832627b4f6&type=51&var_name=oAdmin&admin_id=testtest&admin_name=test&admin_password=test

http://data.galaxystatistics.com:8887/?token=098f6bcd4621d373cade4e832627b4f6&type=52&var_name=oAdmin&admin_id=testtest&admin_password=test&answer_str={%22admin_id%22:[%22test%22,%22test2%22,%22test1%22,%22testtest%22]}

http://data.galaxystatistics.com:8887/?token=098f6bcd4621d373cade4e832627b4f6&type=53

(6.2) 用户答案内容修改

URL:http://data.galaxystatistics.com:8887/?token=xxxxxx&type=52&var_name=oAdmin&admin_id=testtest&admin_name=test&admin_password=test&answer_str=test