SAP Concur Developer Center | List Item Web Service v1 -获取列表的列表

这个API已被弃用。

使用过时的API合作伙伴和客户请与SAP的Concur，并讨论移动到最新版本。

详情请参阅API生命周期和弃用策略。

该资源支持以下GET操作:

获取列表的列表
得到列表详细信息
获取列表项

获取列表

描述

检索配置列表的列表。

得到列表请求

         GET /api/expense/list/v1.0/ HTTPS / 1.1主机：www.concursolutions.com授权：OAuth的{访问令牌}内容类型:应用程序/ xml
        

请求参数

一个也没有。

头

授权头

对于有效的Concur用户，授权头带有OAuth令牌。OAuth使用者在Concur中必须具有以下用户角色之一:公司管理员或专业的Web服务管理员，或标准的管理员。这些角色允许用户对整个公司管理数据。

接受头

应用程序/ xml

得到列表响应

http响应

根元素

这个请求将返回一个列表父元素包含列表子元素。这列表元素将包含以下子元素。

子元素列表

元素	描述
id	列表URI与加密ID。
项目链接	该列表项的URI与加密ID。
batch-link	将批料URI与此列表相关联，与加密的ID。
姓名	在用户界面中显示的列表名称。
是供应商	这是否是一个供应商列表。格式:真/假
水平	列表包含的级别数。

成功响应的XML示例

HTTPS/1.1 200 OK内容类型:application/xml

         <名单xmlns =“http://www.concursolutions.com/api/expense/list/2010/02”><列表>http://www.concursolutions.com/api/expense/list/v1.0/I8pq1l$rdSmdrEW23deOjPjyr4Wso0Wq$a< / id >< batch-link >http://www.concursolutions.com/api/expense/list/v1.0/I8pq1l$rdSmdrEW23deOjPjyr4Wso0Wq$a/batch窗列表< /名称><是厂商>错误的< /是供应商><水平>1< / >水平< items-link >http://www.concursolutions.com/api/expense/list/v1.0/I8pq1l$rdSmdrEW23deOjPjyr4Wso0Wq$a/items/< / >列表<列表>http://www.concursolutions.com/api/expense/list/v1.0/jUwq11frTd$sweNd7s6s8O0fYi$piWwato< / id >< batch-link >http://www.concursolutions.com/api/expense/list/v1.0/jUwq11frTd$sweNd7s6s8O0fYi$piWwato/batch组织列表< /名称><是厂商>错误的< /是供应商><水平>4.< / >水平< items-link >http://www.concursolutions.com/api/expense/list/v1.0/jUwq11frTd sweNd7s6s8O0fYi piWwato /项目/美元< / >列表<列表>http://www.concursolutions.com/api/expense/list/v1.0/4q2Hy86r45Klls pseQEhNpz8Oxal7ytRe美元< / id >< batch-link >http://www.concursolutions.com/api/expense/list/v1.0/4q2Hy86r45Klls pseQEhNpz8Oxal7ytRe美元/批处理航空公司< /名称><是厂商>真正的< /是供应商><水平>1< / >水平< items-link >http://www.concursolutions.com/api/expense/list/v1.0/4q2Hy86r45Klls pseQEhNpz8Oxal7ytRe /项目/美元< / >列表< / >列表
        

得到列表详细信息

描述

检索指定列表的列表详细信息。包括配置信息，而不是列表项。

获取列表详情请求

         GET /api/expense/list/v1.0/_{listID}_ HTTPS/1.1主机:www.concursolutions.com授权:OAuth{访问令牌}内容类型:应用程序/ xml
        

请求参数

{listID}必需的。所需列表的标识符。例子：https://www.concursolutions.com/api/expense/list/v1.0/nqd1YesaKhCWCFIhY8JeBJYf2UGdpwJ2r
URI源:该URI在id元素的Get List of Lists函数。

头

授权头

必需的。对于有效的Concur用户，授权头带有OAuth令牌。OAuth使用者在Concur中必须具有以下用户角色之一:公司管理员或专业的Web服务管理员，或标准的管理员。这些角色允许用户对整个公司管理数据。

接受头

应用程序/ xml

获取列表详细响应

http响应

内容类型

应用程序/ xml

根元素

这个请求将返回一个列表父元素。这列表元素将包含以下子元素。

子元素列表

元素	描述
batch-link	将批料URI与此列表相关联，与加密的ID。
id	列表URI与加密ID。
是供应商	这是否是一个供应商列表。格式：真/假。
项目链接	该列表项的URI与加密ID。
水平	列表包含的级别数。
姓名	在用户界面中显示的列表名称。

成功响应的XML示例

         <列表xmlns =“http://www.concursolutions.com/api/expense/list/2010/02”xmlns:我=“http://www.w3.org/2001/XMLSchema-instance”>< batch-link >https://www.concursolutions.com/api/expense/list/v1.0/nqd1YesaKhCWCFIhY8JeBJYf2UGdpwJ2r/batchhttps://www.concursolutions.com/api/expense/list/v1.0/nqd1YesaKhCWCFIhY8JeBJYf2UGdpwJ2r< / id ><是厂商>真正的< /是供应商>< items-link >https://www.concursolutions.com/api/expense/list/v1.0/nqd1YesaKhCWCFIhY8JeBJYf2UGdpwJ2r/items<水平>1< / >水平旅行社< /名称>< / >列表
        

获取列表项

描述

检索指定列表的列表项。没有指定父列表项代码的请求将返回所有级别1的列表项。带有父列表项代码发送的请求将返回该父列表项以下的所有列表项。可以通过传入筛选字符串来筛选结果集。

获取列表项请求

请求参数

{listID} /项目必需的。所需列表的标识符，以及指示请求是针对列表项的items关键字。例子：https://www.concursolutions.com/api/expense/list/v1.0/_{listID}_/items
{parentCode}可选的。父列表项代码。如果包含这一项，请求将返回此列表项下的所有项目。父代码必须是URL编码的。
过滤器= {过滤器}可选的。结果过滤器。输入的字符串值，将根据该列表项目名称和代码字段进行比较，只有匹配结果将被退回。例子：https://www.concursolutions.com/api/expense/list/v1.0/{_listID_}/items?parentCode={_parentcode_}&filter={_filter_}

头

授权头

接受头

应用程序/ xml

XML示例请求

         GET /api/expense/list/v1.0/jUwq11frTd$ sweNd7s6s8O0fYi $ piWwato/项目/ HTTPS / 1.1主机：www.concursolutions.com授权：OAuth的{访问令牌}内容类型:应用程序/ xml
        

XML请求示例父代码

         GET /api/expense/list/v1.0/jUwq11frTd$ sweNd7s6s8O0fYi $ piWwato/项目?parentCode=US HTTPS/1.1 Host: www.concursolutions.com Authorization: OAuth{访问令牌}内容类型:应用程序/ xml
        

XML示例请求与过滤器

         GET /api/expense/list/v1.0/jUwq11frTd$ sweNd7s6s8O0fYi $ piWwato/项目？过滤器=United HTTPS/1.1主机:www.concursolutions.com授权:OAuth{访问令牌}内容类型:应用程序/ xml
        

获取列表项响应

http响应

响应身体根元素

这个请求将返回一个列表项父元素，带有项目清单每个项目的子元素返回。这项目清单元素将包含以下子元素。

列表项的子元素

元素	描述
姓名	该列表项的名称。
levelxcode	所有指定级别的项目代码，其中x被替换为级别编号。如果请求的是2级项目的子项目，则level1code那level2code,level3code元素将被返回。
项目链接	的URI，包括父代码值，以请求此列表项下方的列表项。

成功响应的XML示例

         <列表项xmlns =“http://www.concursolutions.com/api/expense/list/2010/02”><列表项>美国< /名称>< level1code >我们< items-link >https://www.concursolutions.com/api/expense/list/v1.0/jUwq11frTd sweNd7s6s8O0fYi piWwato美元/项目/美国/<列表项>联合王国< /名称>< level1code >英国< items-link >https://www.concursolutions.com/api/expense/list/v1.0/jUwq11frTd$sweNd7s6s8O0fYi$piWwato/items/UK/<列表项>加拿大< /名称>< level1code >加利福尼亚州< items-link >https://www.concursolutions.com/api/expense/list/v1.0/jUwq11frTd$sweNd7s6s8O0fYi$piWwato/items/CA/<列表项>墨西哥< /名称>< level1code >MX< items-link >https://www.concursolutions.com/api/expense/list/v1.0/jUwq11frTd$sweNd7s6s8O0fYi$piWwato/items/MX/
        