如何获取inspur API开放平台访问token分步指南
在当今的数字媒体创新、软件开发实践以及广泛的业务场景中，高效的数据处理与资源访问能力已成为推动项目成功与业务增长的重要驱动力。Inspur（浪潮）作为领先的IT解决方案提供商，其API开放平台为开发者们提供了丰富的数据接口和服务，极大地促进了业务自动化与数据智能化的实现。特别是在需要高效访问和处理大规模数据时，Inspur API开放平台无疑是一个强大的支持。本文将详细指导你如何获取Inspur API开放平台的访问token，为你开启高效、安全的数据访问与处理能力的大门。接下来，我们将一步步分解这一过程，从平台注册到token申请，再到初步验证与应用，确保你能够轻松掌握并充分利用Inspur API开放平台的强大功能。
1. 登录/注册inspur API开放平台
2. 获取token
URI
POST /auth/v1/token
请求参数
content-type:application/json;
| 名称 | 位置 | 类型 | 是否必须 | 描述 |
|---|---|---|---|---|
| username | body | String | 是 | 用户名（若为子用户，则用户名为“主用户名.子用户名”） |
| password | body | String | 是 | 密码 |
返回参数
| 名称 | 位置 | 类型 | 是否必须 | 描述 |
|---|---|---|---|---|
| access_token | Body | String | 是 | Token |
| expires_in | Body | String | 是 | 失效时间（秒） |
| refresh_token | Body | String | 是 | 刷新token |
| refresh_expires_in | Body | String | 是 | 刷新token失效时间（秒） |
示例
请求示例
content-type:application/json; 请求url为：POST https://iam.inspurcloudapi.com/auth/v1/token
{
"username":"cloud-operator.testuser1",
"password":"123456a?"
}响应示例
{
"access_token": "eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lk...ygzrBPvyK5A",
"expires_in": 5400,
"refresh_expires_in": 7200,
"refresh_token": "eyJhbGciOiJIUzI1NiIsInR5cCIgOiAiSldUIiwi...nh54bxMbC6Dsg",
"token_type": "bearer",
"not-before-policy": 0,
"session_state": "f2e3f54e-5251-4cab-a12b-d918d3687e7f",
"scope": ""
}3. 发送请求
公共参数
公共请求头
| 名称 | 参数类型 | 是否必须 | 说明 |
|---|---|---|---|
| Authorization | String | 是 | 用户token，用于鉴权，格式为“Bearer + 空格 + 通过GetToken接口获取的token” |
公共请求参数
| 名称 | 参数类型 | 是否必须 | 说明 |
|---|---|---|---|
| Action | String | 是 | 操作指令名称，取值参阅API概览 |
| Timestamp | String | 是 | 当前 UNIX 时间戳，可记录发起API请求的时间。 |
| Nonce | String | 是 | 随机正整数，与 Timestamp 联合起来, 用于防止重放攻击。 |
| Version | String | 是 | API版本号，格式为YYYY-MM-DD。当前取值：2019-01-31 |
| Format | String | 否 | 返回参数的语言类型。取值范围：json | xml。默认值：xml |
通用请求返回值
正常返回
| 返回值 | 说明 |
|---|---|
| 200 | 请求成功。 |
| 201 | 请求成功并且服务器创建了新的资源。 |
| 202 | 服务器已接受请求，下发的任务会延迟处理。 |
| 204 | 服务器成功处理了请求。 |
异常返回
| 返回值 | 说明 |
|---|---|
| 300 multiple choices | 被请求的资源存在多个可供选择的响应。 |
| 400 Bad Request | 服务器未能处理请求。 |
| 401 Unauthorized | 被请求的页面需要用户名和密码。 |
| 403 Forbidden | 对被请求页面的访问被禁止。 |
| 404 Not Found | 服务器无法找到被请求的页面。 |
| 405 Method Not Allowed | 请求中指定的方法不被允许。 |
| 406 Not Acceptable | 服务器生成的响应无法被客户端所接受。 |
| 407 Proxy Authentication Required | 用户必须首先使用代理服务器进行验证，这样请求才会被处理。 |
| 408 Request Timeout | 请求超出了服务器的等待时间。 |
| 409 Conflict | 由于冲突，请求无法被完成。 |
| 500 Internal Server Error | 请求未完成。服务异常。 |
| 501 Not Implemented | 请求未完成。服务器不支持所请求的功能。 |
| 502 Bad Gateway | 请求未完成。服务器从上游服务器收到一个无效的响应。 |
| 503 Service Unavailable | 请求未完成。系统暂时异常。 |
| 504 Gateway Timeout | 网关超时。 |
提交任务类请求结果
响应
- 正常响应要素说明
| 名称 | 参数类型 | 说明 |
|---|---|---|
| RequestId | String | 请求流水号 |
| Code | String | 返回码 |
| Data | Data数据结构 | 返回结果数据 |
| Message | String | 描述信息 |
- 异常响应要素说明
| 名称 | 参数类型 | 说明 |
|---|---|---|
| RequestId | String | 请求流水号 |
| Code | String | 返回码,异常响应时返回错误码 |
| Message | String | 异常描述 |
- 响应样例
正常响应：
<CreateOrImportKeypairResponse>
<Code>201</Code>
<Data></Data>
<RequestId>c213c0d1-c40d-4905-89a3-4ec5e3375c5a</RequestId>
<Message>Created</Message>
</CreateOrImportKeypairResponse>异常响应：
<CreateOrImportKeypairResponse>
<Code>101.007003</Code>
<RequestId>2d1b438d-aea5-4edd-b1c2-8c65cc626b21</RequestId>
<Message>名称可能已存在！</Message>
</CreateOrImportKeypairResponse>4. 常见问题
Q：如何找到inspur API开放平台?
A：幂简集成是国内领先的API集成管理平台，专注于为开发者提供全面、高效、易用的API集成解决方案。幂简API平台可以通过以下两种方式找到所需API：通过关键词搜索API(例如，输入’inspur API开放平台‘这类品类词，更容易找到结果)、或者从API hub分类页进入寻找。
Q：子用户是否需要进行实名认证？
A：子用户无需进行实名认证，我们认为子用户是主账号下的员工或程序，具有主账号赋予的某些权限
Q：如何为子用户授权？
A：在控制台策略管理>自定义策略>创建自定义策略，创建相关资源权限的策略（详见操作指南>策略管理>创建自定义策略）。
然后在策略管理>自定义策略，列表中关联用户（详见操作指南>策略管理>关联用户）；或在人员管理>用户管理中为用户授权（详见操作指南>人员管理>为用户授权）
Q：SK密钥丢失？
A：Access Key由浪潮云颁发给访问者。丢失后无法找回，只能通过控制台删除已有密钥再新增。请妥善保存。
Q：Access KEY的正确使用方式是什么，SK密钥丢失了怎么办？
A：
开发者应用访问浪潮云的OpenAPI时，需要使用由浪潮云颁发的SECRET KEY对请求进行签名。并携带签名信息发起请求。这个调用不应该在浏览器端，因为SECRET KEY不可能保存在浏览器端。
开发者需要将请求中的所有内容，包括请求uri、请求Body体、请求方式、请求头（header）及请求参数等信息，按照一定的顺序组装。使用指定的加密算法计算得出签名值signatrue。并携带此签名作为身份凭证访问浪潮云资源。
Q：inspur API开放平台的替代品有哪些？
除了inspur API开放平台，还有其他替代服务商也提供类似api服务，例如：
CYBERARK API开放平台、ConnectionPoint API开放平台、Passbolt API开放平台
更多竞品可以在幂简集成开放平台中找到。
Q：inspur API开放平台这个密钥还适用于哪些api？
获取指定服务信息、获取指定服务的资源类型列表、获取指定资源类型的操作列表
5. 总结
本文全面且细致地介绍了如何获取Inspur API开放平台访问token的分步指南，为开发者们提供了一份条理清晰、操作简便的实用手册。从Inspur API平台的账号注册，到完成开发者身份认证，再到最终成功获取访问token，每一步操作都配以详尽的说明与指导，确保开发者能够轻松、准确地完成整个流程。获取访问token只是利用Inspur API的第一步，如何高效、安全地集成并应用这些强大的数据处理与服务功能才是关键。因此，在本文中，我们不仅指导了如何获取访问token，还强调了获取后进行初步测试与验证的重要性。通过测试，开发者可以确保Inspur API能够顺利集成到应用中，并发挥出最佳效果，从而提升应用的性能和用户体验。本文为开发者们提供了一个全面、详尽且极具实用性的操作指南，帮助他们顺利获取Inspur API开放平台的访问token，并将这一强大的数据处理与服务功能高效地集成到应用中。我们相信，随着开发者们对这一指南的深入理解和实践，将能够在数据处理、业务自动化与数据智能化等领域取得更加显著的成果，为企业的数字化转型与业务增长提供强有力的支持。
