集思录通达信接口-ERP接口介绍_fengxuefeifei的博客_erp接口

ERP集思录通达信接口,接口介绍

ERP集思录通达信接口,接口概况

我们增加了ERP集思录通达信接口,接口，集思录通达信接口,接口的作用有：

简化天思ERP与外围系统的集成将ERP、TCODE、TBOSS协调成一个整体与ERP一起维护…

ERP集思录通达信接口,接口方便与外围程序集成，是现在很通用的一种模式，那么集思录通达信接口,接口是什么意思，我们怎么使用它？

我们经常说的集思录通达信接口,接口，其实就是一个API。

而API，我们可能经常听到，但是不是很明白，先看它的百科介绍：

API，英文全称ApplicationProgrammingInterface，翻译为“应用程序集思录通达信接口,接口”，是一些预先定义的函数，目的是提供应用程序与开发人员基于某软件或硬件得以访问的一组例程，而又无需访问源码，或理解内部工作机制的细节。

知乎上关于API的解释

那么实际工作中怎么使用呢，举我们现在软件的例子：

我们的ERP是一个很完善很完整的系统软件，随着手机的便携性越来越高，价位越来越低，客户越来越希望我们ERP中仓库管理部分能在手机上直接使用，这样方便仓库人员及时处理出入库，但是我们的ERP不支持在手机上使用。怎么办？

我们开发了一套手机APP，也就是我们的TCODE仓库管理系统，也就是我们常说的TCODE。

那TCODE和ERP的数据怎么对接呢？总不能ERP做ERP的，TCODE做TCODE的吧？

这里就用到了API集思录通达信接口,接口，通过ERP的API集思录通达信接口,接口，把ERP系统和TCODE系统对接起来，让数据是相互通的。

再举一个实际的例子，以采购入库单存盘为例：

ERP写好了【登录集思录通达信接口,接口】和【单据保存集思录通达信接口,接口】，其中单据保存集思录通达信接口,接口支持采购入库单，TCODE开发了一张采购入库单，在TCODE中先登录，然后录好采购入库单，保存这张单据的时候，直接调用我们ERP的【单据保存集思录通达信接口,接口】，通过这个集思录通达信接口,接口生成一张采购入库单，生成的这张单在ERP中就能看到，并不需要TCODE重新写一段采购入库存盘的代码。

同样，以采购入库新增集思录通达信接口,接口为例，我们了解一下实际的集思录通达信接口,接口使用，集思录通达信接口,接口是一段定义好的函数，我们提供好了集思录通达信接口,接口的种类和集思录通达信接口,接口的模式，如果有其他系统需要调用我们的集思录通达信接口,接口，直接根据我们的格式传好参数后调用就行。

现在很多客户有一些特殊的需求，比如需要用其他来源数据做入库，客户写了一个小程序，这个小程序有自己的数据库用来存放数据，他希望存盘能同时生成一张我们系统的采购入库单，那这时候就可以用到我们的【登录集思录通达信接口,接口】和【单据保存集思录通达信接口,接口】。

ERP集思录通达信接口,接口实例介绍

我们需要使用【登录集思录通达信接口,接口】来模拟用户登录，得到返回的LoginId，这个LoginId可以理解成此次登录的身份标识，其他集思录通达信接口,接口调用的时候必须用到这个身份标识。比如我们需要用到【单据保存集思录通达信接口,接口】，那么就必须先取得这个LoginId。

【登录集思录通达信接口,接口】的介绍

|基本信息

集思录通达信接口,接口名称	用户登录	根据语言别、授权凭证等实现用户登录
请求状态	POST	请求状态一般有四种：使用时可简单理解为 1、POST /url 创建 2、DELETE /url/xxx 删除 3、PUT /url/xxx 更新 4、GET /url/xxx 查看
集思录通达信接口,接口路径	http://localhost:23798/api/User/login	向服务器地址发送POST请求

|请求参数

Languageid	0	是		客户端语言别,0:简体 1:繁体 2:英文
Authorization		是	Basic REVNT19BRE1JTjoxMjM=	授权凭证，由”登录代号_ 操作员代号:密码“组成字符串的Base64加密值，比如 Basic DEMO_ADMIN:123。
ClientType		否	TestMgr	用户自定义的客户端识别号，比如客户是WMS系统，可以自定义ClientType=“WMS”
Content-Type		否	application/json	用于指定数据的传输类型，其他接用调用时必须用到，现在默认使用“application/json”格式，以后会支持其他格式

|返回数据

LoginId	string	否	返回的LoginId
CompNo	string	否	帐套代号
UserNo	string	否	操作员代号
LoginIdExpiry	number	否	登录超时时间(秒)
ClientType	string	否	客户端自定义识别号
LanguageId	number	否	客户端语言别

|调用范例

返回的Json：

{
    'LoginId': 'e835943e-55c2-4bf0-832d-6f4166592941',
    'CompNo': 'DEMO',
    'UserNo': 'ADMIN',
    'LoginIdExpiry': 604800,
    'ClientType': 'WMS',
    'LanguageId': 0
}

|备注

以上介绍说的我们向服务器发送POST请求，请求参数是Languageid、Languageid、ClientType、ClientType，参数的值根据实际的情况录入，运行后返回LoginId、CompNo等字段的值，通过得出的值，我们可以进行后续新增采购入库的操作。

需要注意：

先判断返回的HttpStatusCode是否等于200，如果是则表示调用成功，否则返回错误信息

登录集思录通达信接口,接口不需要频繁调用，只有当没有获得LoginId或登录已超时后才需要再次调用

登录集思录通达信接口,接口返回的LoginIdExpiry以秒为单位，调用方在调用前先记录本地时间，集思录通达信接口,接口返回后将记录的本地时间加上LoginIdExpiry的值，即是下次需要再次调用登录集思录通达信接口,接口的时机

除了登录集思录通达信接口,接口，其它集思录通达信接口,接口调用必须在Headers里面传入LoginId

所有集思录通达信接口,接口都以JSON格式返回

【单据保存集思录通达信接口,接口】的介绍

|基本信息

集思录通达信接口,接口名称	单据保存、修改	根据单据ID、是否为确认单来新增或修改单据
请求状态	POST	请求状态一般有四种：使用时可简单理解为 1、POST /url 创建 2、DELETE /url/xxx 删除 3、PUT /url/xxx 更新 4、GET /url/xxx 查看
集思录通达信接口,接口路径	http://localhost:23798/api/Bill/SaveBill	向服务器地址发送POST请求

|请求参数

Content-Type	application/json	是		用于指定数据的传输类型
LoginId		是	e835943e-55c2-4bf0-832d-6f4166592941	用户登录的LoginId

CallID	是	CallID=PC	调用的单据识别号,比如'SA':表示销售出库单 “PC”:表示采购入库单
isConfirm	是	isConfirm=F	是否确认单

现在使用的是数据库表字段传参来实现，没用统一的字段，所以不用表格列示，后续会修改为统一字段传参

{
  'HeadData': {             //表头数据
    'CUS_NO': 'CS001',       //厂商代号
    'DEP': '0000'           //部门代号
  },
  'BodyData1': [            //表身数据
    {
      'PRD_NO': '1001',     //货品代号
      'QTY': 12.5,             //数量
    }，
    {
      'PRD_NO': '1002',     //第二个货品代号
      'QTY': 1,             //数量
    }
  ]
}

|返回数据

CallID	string	非必须	PC	调用的单据识别号
CallOK	string	非必须	T	执行是否成功, 是:“T” 否:“F”
Data	object	非必须	“TF_TABNAME”: “TF_PSS”, “BIL_ITM”: “0”, “MF_TABNAME”: “MF_PSS”, “BIL_NO”: “PC0C100005”, “BIL_ID”: “PC”	单据信息,JOSN格式
ErrorStr	string	非必须		错误信息

|调用范例

**Body：**使用的是数据库表字段名作为参数名传参，根据实际需求传需要的字段即可

{
  'HeadData': {             //表头数据
    'CUS_NO': 'CS001',       //厂商代号
    'DEP': '0000'           //部门代号
  },
  'BodyData1': [            //表身数据
    {
      'PRD_NO': '1001',     //货品代号
      'QTY': 12.5,             //数量
    }，
    {
      'PRD_NO': '1002',     //第二个货品代号
      'QTY': 1,             //数量
    }
  ]
}

返回的Json：

{
    'CallID':'PC',               // 调用的单据识别号
    'CallOK':'T',                // 执行是否成功, 是:'T' 否:'F'
    'Data':{                     // 单据信息,JOSN格式
      'TF_TABNAME': 'TF_PSS',
      'BIL_ITM': '0',
      'MF_TABNAME': 'MF_PSS',
      'BIL_NO': 'PC0C100005',
      'BIL_ID': 'PC'
    },
    'ErrorStr':''                // 错误信息
}

代码示例

以C#语言为例，举例说明实际开发过程中调用【登录集思录通达信接口,接口】、【单据保存集思录通达信接口,接口】的代码

//登录按钮点击事件（登录集思录通达信接口,接口）
private void btnGetLoginId_Click(object sender, EventArgs e)
        {
            //Basic 64加密 帐套代号_操作员代号:密码
            string authorization = 'DEMO_ADMIN:';
            byte[] b = System.Text.Encoding.Default.GetBytes(authorization);
            authorization = 'Basic ' + Convert.ToBase64String(b);
            
            //集思录通达信接口,接口路径
            HttpWebRequest request = (HttpWebRequest)WebRequest.Create('http://localhost:23798/api/User/login');
     		//Headers
            request.Headers['Authorization'] = authorization;//Basic REVNT19BRE1JTjo=
            request.Headers['Languageid'] = '0';       //语言别
            request.Headers['ClientType'] = 'WMS';     //用户自定义的调用识别
            request.Method = 'POST';                   //请求类型
            request.ContentType = 'application/json';  //传输类型
     		//Body
            string bodyString = '';                    //bodyJson
    
            byte[] buffer = Encoding.UTF8.GetBytes(bodyString);   
            request.ContentLength = buffer.Length;
            try
            {
                request.GetRequestStream().Write(buffer, 0, buffer.Length);
                //执行调用
                using (HttpWebResponse response = (HttpWebResponse)request.GetResponse())
                {
                    using (StreamReader reader = new StreamReader(response.GetResponseStream(), Encoding.UTF8))
                    {
                        MessageBox.Show(reader.ReadToEnd());   //返回数据
                    }
                }
            }
            catch (Exception ex)
            {
                MessageBox.Show(ex.Message);    //错误信息
            }
            
        }

//保存按钮点击事件（保存集思录通达信接口,接口）
private void btnSaveBill_Click(object sender, EventArgs e)
        {
    		//集思录通达信接口,接口路径  传入调用的单据识别号、是否确认单标识
            HttpWebRequest request = (HttpWebRequest)WebRequest.Create('http://localhost:23798/api/Bill/SaveBill?CallID=PC&isConfirm=F');
    		//Headers
            request.Headers['LoginId'] = 'e835943e-55c2-4bf0-832d-6f4166592941';//用户登录的LoginId
            request.Headers['ClientType'] = 'WMS';          //调用方标识
            request.Method = 'POST';                        //请求类型
            request.ContentType = 'application/json';       //传输类型
         	//Body
            string bodyString = '{  'HeadData': {    'CUS_NO': 'CS01', 'DEP': '0001'  },  'BodyData1': [    {      'PRD_NO': '1001',      'QTY': '12.5''    },    {      'PRD_NO': '1002',      'QTY': '1'}  ]}' ;         //bodyJson

            byte[] buffer = Encoding.UTF8.GetBytes(bodyString);
            request.ContentLength = buffer.Length;
            try
            {
                request.GetRequestStream().Write(buffer, 0, buffer.Length);
                //执行调用
                using (HttpWebResponse response = (HttpWebResponse)request.GetResponse())
                {
                    using (StreamReader reader = new StreamReader(response.GetResponseStream(), Encoding.UTF8))
                    {
                        MessageBox.Show(reader.ReadToEnd());   //返回数据
                    }
                }
            }
            catch (Exception ex)
            {
                MessageBox.Show(ex.Message);    //错误信息
            }

        }

程序执行后，就可以生成一张采购入库单，这一段代码里描述了我们ERP集思录通达信接口,接口调用的传入参数和返回数据。这只是一段简单的有其他参数需求时，根据实际需求写入调用参数即可。

JSON介绍

现阶段我们所有集思录通达信接口,接口都以JSON格式返回，那么JSON是什么，怎么使用它？

JSON英文全称JavaScriptObjectNotation，翻译为“JavaScript对象表示法”，是一种与开发语言无关的、轻量级的数据存储格式。是用来存储和交换文本信息的语法。一种数据格式的标准规范，起初来源于JavaScript这门语言，后来随着使用的广泛，几乎每门开发语言都有处理JSON的API。

优点：易于人的阅读和编写，易于程序解析与生产。

数据结构表示

结构样式	{key:value,key:value…}	[value,value…]
举例	{“小明”: “50分”, “小红”: “99分”}	[1,“hi”]

JSON数据示例：首先一个花括号{}，整个代表一个对象，同时里面是一种Key-Value「键-值」的存储形式，它还有不同的数据类型来区分。

//这个 “APP“是包含 2个“对象”的数组，而每个对象下包含多个键值对和一个数组，数组下又包含多个键值对
{
    'APP':[
        {
            'name':'天猫',
            'role':'买买买',
            'carts': [
                { 'name':'洗发水' , 'price':'50' },
                { 'name':'沐浴露' , 'price':'60' }
            ]
        },
        {
            'name':'京东',
            'role':'买买买',
            'carts': [
                { 'name':'键盘' , 'price':'300' },
                { 'name':'鼠标' , 'price':'300' }
            ]
        }
    ]
}

集思录通达信接口,接口测试

我们了解了集思录通达信接口,接口、JSON格式，接下来说一下怎么测试、使用集思录通达信接口,接口。

假设有一个需求，需要开发出查询采购订单的功能，开发写了一个【单据查询集思录通达信接口,接口】，这个集思录通达信接口,接口支持查询采购订单，完成后，我们需要测试这个是否可以正确执行查询采购订单的操作，以及返回的数据是否正确，开发可以在开发环境下查看，那测试、实施人员日常测试、调用调试的时候可以怎么办呢？

调用准备

运行ServrConfig启动ERP服务云主机上防火墙开通237823798端口ERP序列号需要注册集思录通达信接口,接口系统或条码系统如果需要使用单据打印集思录通达信接口,接口，请配置服务的模拟帐户可访问:http://localhost:23798/api/help获取帮助

启动服务

开通端口

注册条码系统并重新注册后注册信息里可以看到

使用单据打印集思录通达信接口,接口时需设置服务控制台

【单据查询集思录通达信接口,接口】的介绍

做好了调用准备后，我们还需要知道【登录集思录通达信接口,接口】和【单据查询集思录通达信接口,接口】的说明介绍，以及我们需要确认【单据查询集思录通达信接口,接口】是否支持采购订单，这里因为是开发完成采购订单查询集思录通达信接口,接口，需要测试这个集思录通达信接口,接口，所以我们只需要知道【单据查询集思录通达信接口,接口】文档即可。

【登录集思录通达信接口,接口】在上面已经有介绍了，【单据查询集思录通达信接口,接口】可以找研发提供，或者在http://localhost:23798/api/help帮助页下找到【查询集思录通达信接口,接口】的帮助，点击去查看这个集思录通达信接口,接口的请求类型、请求地址、请求参数等。

查询集思录通达信接口,接口点进去只能看到四个参数，暂时这里还不完善。

因帮助页文档不完善，另外找了研发提供了【采购订单查询集思录通达信接口,接口】的说明，整理如下：

|基本信息

集思录通达信接口,接口名称	单据查询	根据单据ID、单据号码、单据项次查询单据信息
请求状态	GET	请求状态一般有四种：使用时可简单理解为 1、POST /url 创建 2、DELETE /url/xxx 删除 3、PUT /url/xxx 更新 4、GET /url/xxx 查看
集思录通达信接口,接口路径	http://localhost:23798/api/Bill/QueryBill	向服务器地址发送GET请求

|请求参数

Content-Type	application/json	是		用于指定数据的传输类型
LoginId	679e0b11-8483-428c-82bd-83383b57e9f5	是		用户登录的LoginId

CallID	是	CallID=PO	调用的单据识别号,比如'SA':表示销售出库单 “PC”:表示采购入库单
Bil_Id	是	Bil_Id=PO	查询单据ID
Bil_No	是	Bil_No=PO0C110001	查询单据号码
Bil_Itm	是	Bil_Itm=0	查询单据项次

|返回数据

Postman测试工具

做好前面的准备工作后，就可以开始测试了，用什么测试工具，怎么操作？

这里我们介绍一种测试工具，叫PostMan，其他的工具同理。

下面详细介绍一下PostMan的用法。

PostMan是一款网页调试和集思录通达信接口,接口测试的工具，能够发送任何类型的HTTP请求，支持GET/PUT/POST/DELETE等方法，通过直接填写URL，headers，body等，就可以发送一个请求，非常简单易用，是集思录通达信接口,接口测试必备利器。这里我们用它来做集思录通达信接口,接口测试。

下载PostMan，下载地址可以找我们提供，打开PostMan程序就可以直接使用了，跳过登录账户步骤、跳过更新提示，当弹出创建提示框时，可以选择创建”Collection“，弹出新建集思录通达信接口,接口窗口，在这个窗口上录入一个名称，点击“Create“创建即可。

若不小心关掉了这一步，在主界面上点击”New“按钮，或者点击新增的小标也可以打开创建窗口。

创建好集思录通达信接口,接口后，就可以在右边进行请求了，此时我们需要创建两个请求，一个是进行”用户登录“请求、一个是进行”采购订单查询“请求，先创建一个登录请求，通过登录请求的得出LoginId，然后传入LoginId到采购订单查询请求中，进行查询请求。

先建立一个请求，选择请求类型为“POST”，输入请求地址“http://localhost:23798/api/User/login”，点击到“Authorization”授权页签，在“TYPE”下选择“BasicAuth'，然后在Username下输入”DEMO_ADMIN'，在Password下输入密码，点击“PreviewRequest”后自动在“Headers'请求头页签下生一个key为”Authorization“，VALUE为”BasicREVNT19BRE1JTjo=“的请求头参数。

继续在”Headers“请求头页签下，输入其他的请求头参数，比如必须输入的”Languageid‘参数，不必须输入的“ClientType”、“Content-Type”页可以填入也可以不填入。手动输入的参数可以上移、下移、取消勾选、删除等。自动生成的参数不可以移动、修改、删除。

录入好参数后，点击“Send”按钮，界面下面“Body”页签下显示返回的数据。在返回数据下找到“LoginId”，LoginId后面的那一串字符就是我们后面需要用的参数。

若想以后继续使用这个请求，可以点击“Save”进行保存，保存时可以给这个请求录入名称，选择保存到哪一个集思录通达信接口,接口，点击“saveto'按钮保存即可。

保存好”用户登录'请求后，在点击“加号”小标按钮，在新建一个请求，选择请求类型为“GET”，输入请求地址“http://localhost:23798/api/Bill/QueryBill“，在”Params“参数页签下，输入参数CallID、Bil_Id、Bil_No、Bil_Itm，以及这些参数对应的值。输入的参数会体现在地址后面，所以输入请求地址的时候，可以直接录入”http://localhost:23798/api/Bill/QueryBill?CallID=PO&Bil_Id=PO&Bil_No=PO0C110001&Bil_Itm=0“，输入这样的地址，”Params“参数页签下会自动显示这四个参数。所以输入地址时如果知道参数可以直接把参数带上。

填好地址和参数后，在点击”Headers“请求头页签，输入请求头参数Content-Type、LoginId以及对应的值。”Content-Type“参数的值现在一般是”application/json“，”LoginId“的值是前面”用户登录“请求后得出的LoginId值。录好后，点击”Send“按钮，界面下面“Body”页签下显示返回的数据。返回数据是JSON数据，能看到有”HEADDATA“、”BODYDATA1“等字段时，表示获取到表头、表身信息，此时就表示集思录通达信接口,接口调用正确。也可以看”Status“状态，”Status“状态为200时，也表示这个集思录通达信接口,接口请求是通过的。但是”Status“只能表示集思录通达信接口,接口正常，并不能看出结果是否正常。

上面我们返回的数据特别多，判断返回数据正确是去判断能看到有”HEADDATA“、”BODYDATA1“等字段，这样不便于我们很直观的确认返回是否正确，我们可以在”Tests“测验页签下写入判断，判断返回数据是否有”HEADDATA“字段，有时提示”PASS“通过，没用时提示”FAIL“失败。

点击到”Tests“测验页签，在右方红色字体处下拉点击“Responsebody:containsstring'，点击后，在左边框内自动生成一串代码：代码如下：

pm.test('Body matches string', function () {
    pm.expect(pm.response.text()).to.include('string_you_want_to_search');
});

修改测试命名以及检测测HEADDATA字段是否存在，修改的代码如下：

pm.test('检测是否返回HEADDATA字段', function () {
    pm.expect(pm.response.text()).to.include('HEADDATA');
});

写好判断后，点击”Send“按钮运行集思录通达信接口,接口，查看下方的”TestResults“页签后面的文字是什么颜色，绿色表示存在，红色表示不存在。点击到”TestResults“页签后，可以看到下面有是否通过的标志，当返回数据有”HEADDATA“字段时提示”PASS“通过，没用时提示”FAIL“失败。

此时，我们得到了采购订单查询集思录通达信接口,接口返回的数据，但是这个数据的模式我们看起来不直观，这里我们需要用JSON解析工具，将这一段JSON数据解析成比较直观的JSON格式。

这里使用的是JSON解析，有很多JSON解析的工具，也有很多在线解析的网址，这里不做深入介绍，我们随便搜索了一个JSON在线解析网址：https://www.sojsocom/，打开后，选择”JSON解析“页签，将我们通过执行【单据查询集思录通达信接口,接口】得到的返回数据填入到代码框，点击”检验/格式化“按钮，弹出”当前内容是一个字符串，是否需要转成JSON对象“，点击”确认“，就可以得出比较直观的JSON格式的数据了。

转换后的数据，如下，这个格式可以清晰的看到表头信息，表身信息，以及每个信息的值。这个方式比较清晰直观，便于我们判断数据正确性。

同用户登录请求一样，若想以后继续使用这个请求，可以点击“Save”进行保存，保存时可以给这个请求录入名称，选择保存到哪一个集思录通达信接口,接口，点击“saveto'按钮保存即可。

保存请求后，在Postman左边集思录通达信接口,接口点击会展开这个集思录通达信接口,接口下保存的请求，点击请求后显示时也显示的时名称。

Postman还有很多其他用法，这里就不一一介绍了。网上也有很多教程，有兴趣的可以去查看以下。

集思录通达信接口,接口测试工具还有很多，比如RestletClient、Mockbin等工具，这些公允运行道理都是差不多，根据实际需求选择一个使用即可。

现有集思录通达信接口,接口的类型

列示几个常用类型，还有很多集思录通达信接口,接口，这里没用一一列示。

用户登录	登录	POST	http://localhost:23798/api/User/login
账套验证	账套验证	POST	http://localhost:23798/api/WMS/GetToken
单据保存、修改	单据操作	POST	http://localhost:23798/api/Bill/SaveBill
单据打印	单据操作	POST	http://localhost:23798/api/Bill/PrintBillReport
单据审核	单据操作	POST	http://localhost:23798/api/audit/executeaudit
单据查询	单据操作	GET	http://localhost:23798/api/Bill/QueryBill
单据删除	单据操作	POST	http://localhost:23798/api/Bill/DeleteBill
查询视窗	查询	GET	http://localhost:23798/api/Bill/QueryWin_GetData
货品履历查询	查询	GET	http://localhost:23798/api/MrpCZ/GetMrpCZData
货品库存查询	查询	GET	http://localhost:23798/api/TbrECC/GetPrdStock_One
详细资料查询	查询	GET	http://localhost:23798/api/Bill/QueryDataDetail

现有集思录通达信接口,接口的单据

这些单据都有新增、删除、修改、查询的集思录通达信接口,接口

PO	采购订单	否	IJ	库存调整单	否
SO	销售订单	否	T6	采购入库送检	否
PC	采购入库单	是	TY	采购入库验收	否
PB	采购入库退回单	否	TP	生产缴库验收	否
SB	销售出库退回单	否	W1	库存入仓单	否
TW	托外加工单	否	WO	库存出仓单	否
WT	批次托外单	否	MM	成品缴库单	是
TC	托工退回单	否	M2	生产退料	是
M4	托工领料	是	M3	生产补料	是
M5	托工退料	是	YB	采购验收退回	否
M6	托工补料	是	YM	制成品验收退回	否
M7	非生产领料	否	YK	托工验收退回	否
M8	非生产退料	否	MB	BOM组合生产单	否
IC	库存调拨单	否	MD	BOM切割分装单	否
MC	原料调拔单	否	MX	入不良品仓	否
PI	盘点单	否	CK	备货单	否
PJ	盘点单(批号)	否	PN	订单变更	否

扩展知识

HTTP协议

上面所提到的请求类型，Headers、query、Body，这些都是HTTP协议下的东西。

HTTP协议英文全称HyperTextTransferProtocol翻译为超文本传输协议。HTTP协议是一个简单的请求-响应协议，是基于TCP/IP协议之上的应用层协议。HTTP协议定义Web客户端如何从Web服务器请求Web页面，以及服务器如何把Web页面传送给客户端。HTTP协议遵循请求/响应模型。客户端向服务器发送一个请求报文，请求报文包含请求的方法、URL、协议版本、请求头部和请求数据。服务器以一个状态行作为响应，响应的内容包括协议的版本、成功或者错误代码、服务器信息、响应头部和响应数据。

HTTP请求—响应模式

请求报文构成

请求行：包括请求方法、URL、协议/版本请求头请求正文

POST /test.html HTTP/1.1               //请求行  包括请求方法、URL、协议/版本
  //请求头 Header 
HOST：www.test.com?indexid=2           //query query一般指URL中的参数
Content-Length: 16
Content-Type: text/html

  //空白行，代表请求头结束
  //请求正文  body，请求体中的数据
Username=admin&password=admin

响应报文构成

响应行响应头响应正文

HTTP/1.1 200 OK   					   //响应行  包括协议版本  状态码  状态码原因短语
  //响应头 Header
Date: Sun, 15 Nov 2015 11:02:04 GMT  
Content-Length: 360
Content-Type: text/html

  //空白行，代表响应头结束
  //响应正文  body，响应体中的数据

  Hello World

HTTPS协议

一般http中存在如下问题：

请求信息明文传输，容易被窃听截取数据的完整性未校验，容易被篡改没有验证对方身份，存在冒充危险

为了解决上述HTTP存在的问题，就用到了HTTPS。

HTTPS协议英文全称是HyperTextTransferProtocoloverSecureSocketLayer，翻译为超文本传输安全协议。一般理解为在HTTP的基础上加入了SSL/TLS，通过SSL证书来验证服务器的身份，并为浏览器和服务器之间的通信进行加密。

SSL：SSL协议位于TCP/IP协议与各种应用层协议之间，为数据通讯提供安全支持。

TLS：其前身是SSL，目前使用最广泛的是TLSTLS

HTTPS数据传输模式

HTTPS的缺点：

HTTPS协议多次握手，导致页面的加载时间延长近50%；HTTPS连接缓存不如HTTP高效，会增加数据开销和功耗；申请SSL证书需要钱，功能越强大的证书费用越高。SSL涉及到的安全算法会消耗CPU资源，对服务器资源消耗较大。

总结HTTPS和HTTP的区别：

HTTPS是HTTP协议的安全版本，HTTP协议的数据传输是明文的，是不安全的，HTTPS使用了SSL/TLS协议进行了加密处理。http和https使用连接方式不同，默认端口也不一样，http是80，https是44

对于http和https这里都只是做了浅显的介绍，有需要的可以自己去学习。

参考网址：

Base64加密工具

在我们使用Postman工具测试的时候，是通过自带的Base64加密来对账套用户密码来加密，如果工具不带，可以直接下载加密工具或者找在线的加密网址来进行加密。

下面介绍一个在线加密的方式，打开站长工具在线加密网址：http://toochinaz.com/Tools/Base6aspx?jdfwkey=np1b将“账套代号_用户代号:密码”这一串字符录入到左边，点击“Base64加密”按钮，右边就会显示加密后的内容，把”Base64“字符串与得出的字符串用空格组合，得到的就是Authorization的参数值了。

例如账套代号是DEMO，用户代号是ADMIN，密码为12加密后得到的字符串为“REVNT19BRE1JTjoxMjM=”，与”Base64“字符串用空格组装后，得到的字符串为“BaseREVNT19BRE1JTjoxMjM=”，这个就是Authorization的参数值。

在线加密工具的用法

文章为作者独立观点，不代表股票程序化软件自动交易接口观点