开放平台/接口 怎么使用

这是调用 Oinone 开放平台 API 的完整教程,适合用于集成调试、自动化测试,或构建第三方对接服务。

第一步:获取 Access Token

image-(1)

请求方式:

POST https://one.oinone.top/openapi/get/access-token

在此以 one.oinone.top 环境为例

请求参数(JSON 格式):

{
  "appKey": "34aa5eeaccf242da8a865c3c97e1",
  "appSecret": "P4FxaOwkbQsmRKJ/19CQ0zJeZxTbgIqeT+xVSaBnQDQvgeJUfqn1nWGBIJ8yEM8W7tqzHA2hTpXcJpKGKpzXM/bcl6kiQuCnnVR4EY7ViAG4Zo3D8Q+TCTfNiaeah1aTqnotFQAxqK1kD4QMGzIFtukuLri+FOpPVRYgVrWezDvbD0UtJX53LMOLcSDFb7WLp7UpEBVxBJ5WwhWJC8pyvwYP0qLdENWopMQ50ApU4hedRO/+R4BTVCh3kLEylL2FBbUZ0xo4kBF9pqZ/cxTyYW/s/fxBDCjt+G4cj5GdwJED3+dObgnjYTNkcS4dt5DYBokKAK58I0ax5wXJqWD2ic4VTJPjehNmIfi+Pyk2GMb4tSPDN/gWJAafd5a5JipKo1Nf8gkADyqkFyfjhqfoIrNri8X/Rf8CcZKKG+cNFSs8Y47CKkmdFPRMoiuSkFVAQPD6T9s16BnqIpHRAzppG94G2v1065zAPtY/BApjcQbQ3e1ATP8bX4O4r0zubKV2PmbK6wUuS7uzxJryl5f5BW6hTKLlzsOnd1jpq+Xzj+qXXq+uu5tKl0jRhi2IhJEmVzhTGWvr72bAt3WJT23qp4aZFH+CY1AU38QSTs="
}

返回示例:

{
    "access_token": "LA8pExX2mklGpDM8PvtXc3o7FGJR0YbRRk/YnFXSdLS643jcWcL6X+qCJc",
    "success": true,
    "errorCode": 0,
    "expires_time": 7200,
    "errorMsg": "ok"
}

第二步:调用其他接口(以测试接口为例)

接口路径为:GET /openapi/{spaceId}/test/sleep

image

请求示例:

GET https://one.oinone.top/openapi/734899935484863728/test/sleep?sleep=1000

Query 参数:

  • sleep=1000(单位毫秒)

Header 参数(需添加 token):

Authorization: Bearer {accessToken}

举例完整 Header:

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR...

⚠️ 注意事项:

  • accessToken 通常有过期时间(如 2 小时),请在有效期内使用或定期刷新。
  • 若接口返回 401 Unauthorized,请检查 token 是否过期或格式错误。
  • 如果有网关或防火墙,确保已将接口地址列入白名单。

本文来自投稿,不代表Oinone社区立场,如若转载,请注明出处:https://doc.oinone.top/shu-shi-oinone-xue-yuan/chan-pin-chang-yong-gong-neng-jiang-jie/ji-cheng-she-ji-qi/21336.html

(0)
萧炎的头像萧炎数式员工
上一篇 4小时前
下一篇 4小时前

相关推荐

  • 开放应用自定义请求解密处理函数&响应加密处理函数

    前置条件:需要引入eip依赖 <dependency> <groupId>pro.shushi.pamirs.core</groupId> <artifactId>pamirs-eip2-api</artifactId> </dependency> 请求解密 import org.apache.camel.ExtendedExchange; import pro.shushi.pamirs.eip.api.IEipDecryptProcessor; import pro.shushi.pamirs.eip.api.constant.EipFunctionConstant; import pro.shushi.pamirs.meta.annotation.Fun; import pro.shushi.pamirs.meta.annotation.Function; import pro.shushi.pamirs.meta.annotation.fun.extern.Slf4j; @Fun(EipFunctionConstant.FUNCTION_NAMESPACE) public class DefaultEipDecryptImpl implements IEipDecryptProcessor { private static final String FUN = EipFunctionConstant.OPEN_REQUEST_DECRYPT_PREFIX + "SM4"; @Override @Function.fun(FUN) @Function.Advanced(displayName = "SM4请求解密处理") @Function(name = FUN) public void processor(ExtendedExchange exchange) { // 开放接口 EipOpenInterface openInterface = (EipOpenInterface) exchange.getProperties().get(OpenApiConstant.EIP_OPEN_INTERFACE); // 应用 EipApplication application = (EipApplication) exchange.getProperties().get(OpenApiConstant.EIP_APPLICATION_KEY); // 请求体 String body = exchange.getMessage().getBody(String.class); String result = decrypt(body); exchange.getIn().setBody(result); } private String decrypt(String body) { // TODO 解密 return null; } } 响应加密 import org.apache.camel.ExtendedExchange; import pro.shushi.pamirs.eip.api.IEipEncryptionProcessor; import pro.shushi.pamirs.eip.api.constant.EipFunctionConstant; import pro.shushi.pamirs.meta.annotation.Fun; import pro.shushi.pamirs.meta.annotation.Function; import pro.shushi.pamirs.meta.annotation.fun.extern.Slf4j; @Fun(EipFunctionConstant.FUNCTION_NAMESPACE) public class DefaultEipEncryptionImpl implements IEipEncryptionProcessor { private static final String FUN = EipFunctionConstant.OPEN_RESPONSE_ENCRYPTION_PREFIX + "SM4"; @Override @Function.fun(FUN) @Function.Advanced(displayName = "SM4响应加密处理") @Function(name = FUN) public Object processor(ExtendedExchange exchange, Object body) { // TODO 加密body return body; } }

    2025年4月25日
    21100
  • 集成设计器如何配置使用

    相关知识点文档参考:集成接口一键发布生成开放平台接口:https://doc.oinone.top/designer/eipdesigner/6454.html集成接口与数据流程的使用:https://doc.oinone.top/designer/eipdesigner/4414.html

    2024年9月30日
    29700

Leave a Reply

登录后才能评论