协会宝开放平台

开发前必读

更新时间: 2019-03-29

协会宝开发文档阅读说明

协会宝平台开放了丰富的服务端接口能力,开发者可以借助这些接口能力,实现协会系统与协会宝平台的数据互通。
调用协会宝平台接口时,需使用HTTPS协议、JSON数据格式、UTF8编码,访问域名为https://www.xiehuioa.cn。POST请求请在HTTP Header中设置 Content-Type:application/json。

接口说明格式如下:

请求方式:GET/POST(HTTPS)
请求地址:...
请求包体:
...
参数说明:
...
SDK请求示例:
...
返回结果:
...

1)请求方式:标明接口调用的HTTP方法,区分HttpGet/HttpPost请求。所有的请求都为HTTPS协议。
2)请求地址:接口的请求地址。
3)请求包体/参数说明:标明请求参数示例及说明,参数说明包括字段含义、取值范围。
4)SDK请求示例:使用SDK时,调用接口的代码示例。
5)返回结果/参数说明:标明返回参数示例及说明。所有接口的返回结果里都有IsSuccess。开发者需根据IsSuccess是否为true判断是否调用成功。

获取appkey和appsecret

登入协会宝平台,进入相应协会,在菜单栏上展开"系统管理",点击进入"接口说明"页面,获取对应的appkey和appsecret。

image.png

生成timestamp

生成timestamp范例如下:


C#生成timestamp
string timestamp =(DateTime.Now.ToUniversalTime().Ticks - 621355968000000000) / 10000000).ToString()

获取associationCode

登入协会宝平台,进入相应协会,在菜单栏上展开"系统管理",点击进入"协会资料管理"页面,获取对应的associationCode。

image.png

生成token

生成token方法如下:


//第一步:把字典按key的字母顺序排序
IDictionary<string, string> sortedParams = new SortedDictionary(parames);
IEnumerator<KeyValuePair<string, string>> dem = sortedParams.GetEnumerator();

//第二部 把所有的名字和参数值串在一起 "id=111&timestamp=222"
StringBuilder queryStr = new StringBuilder();
while (dem.MoveNext())
{
    string key = dem.Current.Key;
    string value = dem.Current.Value;
    if (!string.IsNullOrEmpty(key))
    {
        queryStr.Append(key.ToLower()).Append("=").Append(value.ToLower()).Append("&");
    }
}
string str = queryStr.ToString().TrimEnd('&');

//MD5加密
string token = StringHelper.Md5(str);
以上内容是否对您有帮助:
提交成功,感谢您的反馈!