ajax 泛微oa表单js_接口调用示例

## **业务保存类接口格式说明**

#### 接口协议主要采用http(s)，因此下面从请求头，请求体，响应体方面做出说明

* **请求头格式**

|请求头标识|必填|内容|备注|

| --- | --- | --- |--|

|Authorization|Y|Bearer [token-data](接口访问授权.md) |遵循w3c标准|

|Accept|Y| application/json;charset=utf-8|遵循w3c标准|

|Content-Type|Y| application/json;charset=utf-8|遵循w3c标准|

|X-ThirdSysId|Y|FW-OA|泛微OA系统标识 |

* **请求体参数**

|参数名|类型|必填|说明|示例|

|--|--|--|--|--|

|formId|string|N|URI已包含| |

|operationNo|string|N|URI已包含| |

|billData|JString|Y| 本参数是数组，每个数组内对象的封包结构参考：[封包结构参考](数据字典介绍.md)||

* **响应体参数**

|参数名|类型|必含|说明|示例|

|--|--|--|--|--|

|operationResult|jobject|Y| | |

|  complextMessage|string|Y| | |

|    successMessages|jarray|Y|成功类消息| |

|    errorMessages|jarray|Y|错误类消息| |

|    warnMessages|jarray|Y|警告类消息| |

|    hasMessage|bool|Y|是否有消息| |

|  isSuccess|bool|Y|是否操作成功| |

|  srvData|any|Y|接口返回数据| 本属性是实际每个操作返回的数据，对保存操作而言，它是一个数组，其它操作返回的可能是字典，每个接口返回都可能不太一样|

|    [0]|jobject|Y|数组对象| |

|      id|string|Y|保存后内码| |

|      number|string|Y|保存后编码| |

|      name|string|Y|保存后名称| |

## **场景示例描述**

假定现有一第三方系统(如：XXOA)，需要将其系统里的【品牌】资料同步到易到家系统。现在我们在编写同步代码之前需要按以下步骤拿到几个关键信息：

1、通过[数据字典](数据字典介绍.md)功能，查找到业务对象标识，这里得到本对象的formId为：ydj_brand，同样从数据字典中得到发布的数据结构：

{

"id": "",

"fname": "菲尼斯",

"fdescription":