配置文件v1 -用户

重要的:此API目前处于预发布状态,仅供已批准的早期访问参与者使用。该API还在开发中,在正式发布之前可能会进行更改。要成为早期访问参与者,请联系您的SAP Concur代表。

开始-公司的API-用户API

用户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 服务不可用 -

在这一页上