配置文件v1 -用户
重要的:此API目前处于预发布状态,仅供已批准的早期访问参与者使用。该API还在开发中,在正式发布之前可能会进行更改。要成为早期访问参与者,请联系您的SAP Concur代表。
的用户API用于帮助提供和管理多个Concur产品(包括Expense、Invoice、Request、Travel和TripIt)的用户帐户和配置文件细节。
版本
1.0
使用范围
的名字 | 描述 | 端点 |
---|---|---|
user.read |
读取配置文件信息。 | 得到 |
user.write |
读取和更新配置文件信息。 | GET、POST |
模式定义
User模式的灵感来自于跨域身份管理系统(SCIM),特别是:
用户模式的最新版本总是可以在以下位置获得:user.json.
获取用户
配置文件支持使用访问令牌检索用户信息。访问令牌将限制您可以查询的用户帐户以及用户属性。你可以使用以下端点来查找你的用户:
GET /profile/v1/me(需要访问令牌)
旋度的例子:
curl -k -v -H "授权:承载$access-token" "https://$host/profile/v1/me"
上述调用将检索一般用户配置文件信息。用户资源还支持a模式
参数来限制或展开返回的数据。要限制返回的数据量,可以使用?模式=紧凑
.要检索与费用相关的数据,还可以使用?模式=费用
.还可以为参数提供逗号分隔的模式列表,例如?模式=紧凑、费用
.
用户详细信息
这是一个示例用户响应,没有紧凑,但有费用模式。
{“活跃”:真正的,“id”:“1 c1e5ec5-1abc-4edd-a92a-bc551d0dfcd7”,“userType”:“企业”,“元”:{“创建”:“2017 - 03 - 30 - t00:00:00.000”,“lastModified”:“2017 - 07 - 03 - t17:46:00.000”,“principalType”:“用户”,“resourceType”:“EnterpriseUser”},“preferredLanguage”:“en”,“dateOfBirth”:“1990-01-01”,“模式”:[“com:同意:用户:1.0”,com:同意:员工:1.0”,com:同意:TravelPreferences: 1.0”,“com:同意:程序:1.0”,“com:同意:文档:1.0”,“com:同意:费用:0.2”],“性别”:“男性”,“电子邮件”:[{“价值”:“1 @profile-58dd7cd7.com”,“类型”:“业务”,“通知”:真正的,“验证”:假},{“价值”:“test.user@concur.com”,“类型”:“个人”,“通知”:真正的,“验证”:假}],“com:同意:文档:1.0”:{“护照”:[{“数量”:“12345678”,“issuingCountry”:“我们”,“placeIssued”:“贝尔维尤,“dateIssued”:“2017-06-02”,“过期”:“2023-06-30”}],“签证”:[{“数量”:“987654321”,“issuedByCountry”:“对焦”,“placeIssued”:零,“issuedForCountry”:零,“dateIssued”:零,“过期”:“2021-06-03”}]},“地址”:[{“类型”:“家”,“streetAddress”:“profile-58dd7cd7家庭住址”,“位置”:“雷蒙德”,“地区”:“佤邦”,“邮政编码”:“98052”,“国家”:“我们”},{“类型”:“工作”,“streetAddress”:“profile-58dd7cd7办公室”,“位置”:“贝尔维尤,“地区”:“佤邦”,“邮政编码”:“98004”,“国家”:“我们”}],com:同意:员工:1.0”:{“companyUUID”:“d63d3d33 - 9255 - 41 - f4 - 8糖化血红蛋白- dabd6ab08578”,“companyInternalId”:277471,“employeeId”:“1 @profile-58dd7cd7.com”,“职务高低”:"",“managerId”:“ae3204d3 - a94f - 47 -广告- 94 - ef - 8234 - ac40e560”,“orgUnitId”:80265},com:同意:TravelPreferences: 1.0”:{“空气”:{“座位”:{“interrowPosition”:“通道”,“sectionPosition”:“转发”},“homeAirport”:“海”,“吃饭”:“BLML”},“铁路”:{“空间”:“DontCare”,“吃饭”:“DontCare”,“bedCategory”:“DontCare”,“fareSpaceComfort”:“DontCare”,“甲板”:“DontCare”,“教练”:“DontCare”,“床上”:“DontCare”,“泊位”:“DontCare”,“noiseComfort”:“DontCare”,“应急”:“DontCare”,“座位”:“DontCare”},“汽车”:{“吸烟”:“不吸烟”,“carType”:“迷你”,“传播”:“自动”,“gpsEnabled”:假,“skirack”:假},“酒店”:{“earlyCheckin”:真正的,“备注”:零,“池”:真正的,“roomService”:真正的,“foamPillows”:真正的,“accessForBlind”:真正的,“accessForWheelchair”:真正的,“健身”:真正的,“将”:“王”,“餐馆”:真正的,“rollawayBed”:真正的,“吸烟”:“不吸烟”,“婴儿床”:真正的}},“com:同意:程序:1.0”:{“铁路”:[{“默认”:假,“pointsNext”:零,“过期”:零,“nextStatus”:零,“点”:零,“段”:零,“parentChainVendorName”:零,“vendorName”:“AccesRail”,“账户”:“123454321”,“statusBenefits”:零,“状态”:零,“segmentsNext”:零,“parentChainVendorCode”:零,“vendorCode”:b“9”}],“空气”:[],“酒店”:[],“汽车”:[]},“com:同意:费用:0.2”:{“middleInitial”:“T”,“middleName”:“测试”,“loginId”:“1 @profile-58dd7cd7.com”,“分类帐”:“默认”,“countrySubdivision”:零,“driverId”:零,“cuuid”:“8002699190004701412”,“cashAdvanceAccountCode”:零,“emailAddress”:“1 @profile-58dd7cd7.com”,“employeeId”:“1 @profile-58dd7cd7.com”,“firstName”:“同意”,“reimbursementType”:“APCHECK”,“reimbursementCurrency”:“美元”,“活跃”:真正的,“姓”:“用户”,“uuId”:“1 c1e5ec5-1abc-4edd-a92a-bc551d0dfcd7”,“orgUnitData”:[{“orgUnitName”:“费用策略组”,“orgUnitValue”:零}],“customData”:[{“customFieldName”:“发票策略组”,“customFieldValue”:零},{“customFieldName”:“员工管理”,“customFieldValue”:“美国”}],“localeCode”:“en_US”,“countryCode”:“我们”}}
HTTP状态代码
HTTP状态 | 状态 | 描述/错误代码 |
---|---|---|
200 | 成功 | 检索或更新的资源 |
201 | 成功 | 资源创建 |
204 | 成功 | 操作成功执行,没有返回任何内容 |
301 | 搬到永久 | 资源在不同的位置 |
400 | 坏的请求 | - |
401 | 未经授权的 | - |
403 | 被禁止的 | - |
404 | 未找到资源 | - |
429 | 速率限制达到 | - |
500 | 内部错误 | - |
503 | 服务不可用 | - |