Skip to content

回调接口使用说明

deathearth edited this page Mar 5, 2019 · 3 revisions

回调接口使用说明


新增回调接口后,在设置API参数的时候,效果如下:

3-1

  • 回调接口有且只有一个参数,且必须为java.util.Map类型,所有的回调信息都会放到这个map对象中
  • 在定义回调接口的时候,就需要严格按照这个规范编码

三方平台接口回调参数的网关层处理逻辑:
将url中的参数和body中的参数封装到map中,如:
Map<String,String> map = new HashMap<String,String>();
map.put('paramA',Object);
map.put('paramB',Object);
map.put('paramC',Object);
map.put('paramD',Object);
map.put('body',String);
其中 paramX系列的代表url中传递的参数
其中 body为三方回调后传入的实体对象,是一个字符串

对应值,只需要map.get("XXX”)即可获得

###疑问处理 Q1:三方的回调地址中不允许带任何参数,出现’?’形式的字符,但body中可以带参数该如何设置
A1:接口可以定义为 post请求,类型为回调接口,接口的入参有且只有一个,Map<String,String> 类型
请求地址如
https://localhost/callback/user.callback,body中放参数

Q2:三方在回调地址中会拼接个性化参数,且body中也有数据,且需要为get请求?如何设置
A2:接口可以定位为 get请求,类型为回调接口,接口的入参有且只有一个,Map<String,String> 类型
请求地址如
https://localhost/callback/user.callback?sign=xxx&client=xxx,body中放参数

Q3:如果三方回调后需要响应信息,且需要设置响应头?怎么处理?
A3:接口定义为回调类型接口,可以在管理台基本参数里设置,响应头信息,格式为json格式。
{
    "character-encoding":"utf-8",
    "content-type":"text/xml;charset=UTF-8",
    "cache-control":"no-cache"
}

管理台,没有对json数据的正确性做验证,最终都会响应给三方。

Clone this wiki locally