CLR_CallWebAPIEx / CLR_CallWebAPIEx2 [调用外部系统接口] - .Net 平台标准存储过程&函数&CLR方法

**一.概述**
1.CLR_CallWebAPIEx支持对WebApi、WebService接口的调用。对于WebService，是否开启GET、POT方法都支持调用。
2.CLR_CallWebAPIEx2，参数与CLR_CallWebAPIEx一模一样，唯一区别是使用时必须输入@LocalWCFUrl参数值。**说明：**CLR_CallWebAPIEx2为了解决有的网络环境下出现“502 Bad tateway”异常（用CLR_CallWebAPIEx在有的环境下可以调用，在有的环境下出现502错误）

**二.注意**
1. @ReceiveData返回信息中，凡是以“[Err]”开头的异常，有2种原因：CLR没装好（卸载干净重新装）；网络不通或无法访问外网（检查网络）
2. @ReceiveData返回信息中，凡是不以“[Err]”开头的异常，都是接口返回的信息，按信息去排查问题（比如：接口对接要求），问接口对接方。
3. 调用时有异常，询问写CLR_CallWebAPIEx3的人很可能也不知道怎么解决，因为接口怎么对接，怎么调用第3方接口，只有具体接口对接的人知道（比如：对接双方），CLR_CallWebAPIEx3只是一个工具而已

**三.存储过程**
```sql
/*
	Explain:
	1.在存储过程中统一调用 WebApi、WebServer 接口
	2.@Headers、@PostFormParams、@GetParams用于传键值对，键值对格式为key01<|=|>12345<|&|>key2<|=|>99999999，表示为key01=12345；key2=99999999
	3.对于键值对（@Headers、@PostFormParams、@GetParams），可以使用dbo.Fn_GetKeyValueStr(@Dictionary_Table_1)函数生成，避免人为组合错误
	4.你会使用Postman工具，就会使用CLR_CallWebAPIEx3
	5.看提示操作即可（错误时，@ReceiveData返回提示信息,@return_value等于-1）
*/

DECLARE @ReceiveData NVARCHAR(MAX),@return_value INT

EXEC @return_value=dbo.CLR_CallWebAPIEx
    @ReceiveData=@ReceiveData OUTPUT,
    @LocalWCFUrl=N'',--WCF地址
    @IsPost=0, --POST/GET
    @WebAPIUrl=N'',--接口地址
    @UserName=N'',--基本认证：用户。（可选，根据接口调用要求）
    @UserPassword=N'', --基本认证：密码。（可选，根据接口调用要求）
    @TimeOutS=0, --超时时间。（可选）
    @ContentType=N'',--内容类型。（可选，根据接口调用要求）
    @Headers=N'',--请求头，键值对。（可选，根据接口调用要求）
    @PostFormParams=N'',--POST 请求，表单，键值对。（可选，根据接口调用要求）--POST请求二选1
    @PostRawParams=N'',--POST 请求，Raw（可以上传支持的任意格式的文本）。（可选，根据接口调用要求）--POST请求二选1
    @GetParams=N''--GET 请求，表单，键值对。（可选，根据接口调用要求）

SELECT @return_value,@ReceiveData
```

```sql

/*
	1、使用Dictionary_Table类型 和 函数Fn_GetKeyValueStr来获取键值对字符串
*/
DECLARE @FormParams Dictionary_Table;

INSERT INTO @FormParams
     (
         [key],
         value
     )
SELECT 'userName','HH0102'
UNION
SELECT 'UserPassword','sa'

--输出：userName<|=|>HH0102<|&|>UserPassword<|=|>sa
SELECT dbo.Fn_GetKeyValueStr(@FormParams)

```

**四.与Postman的对应关系，只要你会用Postman工具，就会用CLR_CallWebAPIEx**

1. @WebAPIUrl
![](/media//202207/2022-07-15_124218.png)

2. @IsPost
![](/media//202207/2022-07-15_124315.png)

3. @UserName/@UserPassword
![](/media//202207/2022-07-15_124645.png)

4. @ContentType
![](/media//202207/2022-07-15_124742.png)

5. @Headers
![](/media//202207/2022-07-15_124908.png)

6. @PostFormParams
![](/media//202207/2022-07-15_130040.png)

7. @PostRawParams
![](/media//202207/2022-07-15_125545.png)

8. @GetParams
![](/media//202207/2022-07-15_125858.png)