“我的推荐人”接口

                                                                                                           

1. 接口功能概述

本接口可用于记录推荐人代码信息,以代替客户手动输入推荐人号或通过扫描推荐人二维码记录推荐人信息。

通过该接口记录推荐人信息,其效果等同于客户在“手机银行>全部>助手>我的推荐人”中手动输入推荐人号,推荐人归属的的判定规则也与手动输入推荐人号一致。

请注意:接口不支持实时返回本次记录是否为有效推荐,记录成功不代表该用户已经被成功关联为分行的新下载用户,推荐的结果以数仓的报表为准。


2. 接口调用方法

提供三种接口调用方法,前端的ajax、iframe和后台的http请求方法,各环境接口url见下表:

环境

url

ST

http://99.12.73.80/PToolkit/Recommend/Recommend.aspx?recommendcode=123456

UAT

http://99.12.69.80/PToolkit/Recommend/Recommend.aspx?recommendcode=123456

生产

https://mobile.cmbchina.com/PToolkit/Recommend/Recommend.aspx?recommendcode=123456

recommendcode:推荐码,仅限大小写字母、数字,长度6-12位。此接口仅限APP内访问。

接口调用伪代码如下:

(1)前端ajax请求

ajax异步请求我的推荐人。存在跨域问题,总是执行error回调,可忽略不处理。

$.ajax({
    url: url,
    dataType: "html",
    method: "get",
    success: function (data) {
    },
    error: function (XMLHttpRequest, textStatus, errorThrown) {
    }
});


(2)前端iframe

通过iframe标签在当前页面隐藏式打开我的推荐人页面。

var ifr = document.createElement('iframe');
ifr.src = url;
ifr.style.display = 'none';
document.body.appendChild(ifr);
setTimeout(function () {
    document.body.removeChild(ifr);
}, 2000);


(3)后台http请求

在后台发起http get(或post)请求,此方法无需处理响应结果,get方式示例如下。

public void HttpGetRequestStatus(string url, int timeout)
{
    try
    {
        HttpWebRequest request = (HttpWebRequest)WebRequest.Create(url);
        request.Method = "GET";
        request.Timeout = timeout;
        request.UserAgent = HttpContext.Current.Request.UserAgent;//必传
        request.ContentType = "text/html; charset=UTF-8";
        HttpWebResponse response = (HttpWebResponse)request.GetResponse();//无需处理响应
    }
    catch (Exception ex)
    {
    }
}