如何获取Coginiti API开放平台密钥分步指南

在当今的数字化时代，无论是数字媒体创作、软件开发项目，还是我们的日常生活，获取和处理实时、准确的信息都成为了不可或缺的一环。特别是在需要集成多样化功能的应用场景中，如获取实时天气信息，这样的能力更是显得尤为重要。类似于百度地图这样的综合性服务平台，不仅以其卓越的地图服务广为人知，还通过开放的API接口，如天气查询API，为开发者提供了极大的便利，使他们能够轻松地将丰富的天气数据集成到各自的应用程序中。鉴于此，本文将专注于指导你如何顺利获取Coginiti API开放平台的密钥，这一步骤对于开启后续的开发与集成工作至关重要。接下来，我们将通过详细的分步指南，带你逐步完成密钥的申请过程，同时也会简要介绍如何对获取的密钥进行初步的可用性测试，并探讨在使用Coginiti API时可能遇到的一些关键考量因素。

1. 创建或登录到Coginiti API开放平台

2. 创建个人访问令牌

1.在任何页面的右上角，单击您的配置文件图标，然后单击API密钥。

2.在左侧边栏中点击“添加”按钮。这将为您的令牌创建一个新条目。

3.在“令牌名称”下，输入令牌的名称。

4.（可选）在“说明”下，添加注释以说明令牌的用途。

5.在“过期”下，选择令牌的过期时间。

6. (for仅限管理员帐户）如果您以管理员帐户登录，您还可以选择令牌的所有者。令牌将为此用户生成，并将代表该用户通过API访问资源。

7.单击save按钮.

点击保存按钮后，您的令牌将显示在一个单独的弹出表单中。这是我们向您展示代币的唯一时间。你再也看不到它了。请将其保存在一个安全的地方，并使用它来访问Coginiti API。

3. 代码接入

端点：{hostname}/API/v1/exec/script

请求类型：POST

结果格式：JSON

使用curl应用程序的请求示例：

curl -X POST '{hostname}/api/v1/exec/script' \

  --header 'Authorization: Bearer _YOUR_ACCESS_TOKEN_HERE_' \

  --header 'Content-Type: application/json' \

  --header 'Accept: application/json' \

  --data-raw '{

  "path": "@Personal/Reports/performance",

  "params": {

    "start_date": "2012-01-01",

    "end_date": "2012-12-31"

  },

  "connection": {

    "name": "My Connection"

  }

}'

有效载荷：

名称	描述
路径	目录中目录资源的绝对路径。“@Personal”、“@Shared”、“@Legacy”用于指定目录命名空间。
params	对象，其参数名及其值需要传递到脚本中以替代$params。
connection.name	的连接名称

返回一个表示执行结果的对象，否则返回一个错误。

名称	描述
统计数据	统计对象。
stats.started_at	执行开始时的时间戳。
stats.finished_at	执行完成时的时间戳。
stats.duration_ms	以毫秒为单位的执行持续时间。
结果	可选字段。如果执行返回任何数据，则包含结果数据集。

数据集对象具有以下结构：

名称	描述
列	查询返回的列的名称和类型的列表。
数据	查询请求返回的行的列表。每一行本身都是一个列表，按照columns属性指定的顺序保存该行中列的值。

与给定执行相关联的附加元数据作为HTTP头传递。

名称	描述
X-Coginiti-执行开始时间	执行开始时的时间戳

响应示例（包括HTTP头）：

HTTP/2 200 

Date: Wed, 01 Nov 2023 10:03:17 GMT

Content-Type: application/json

X-Coginiti-Execution-Started-At: 2023-11-01T10:03:17.354799859Z

Vary: Accept-Encoding

Server: envoy



{

    "result": {

        "columns": [

            {

                "name": "col_1",

                "type": "INTEGER"

            },

            {

                "name": "col_2",

                "type": "STRING"

            }

        ],

        "data": [

            [

                1,

                "a"

            ],

            [

                2,

                "b"

            ]

        ]

    },

    "stats": {

        "started_at": "2023-08-10T15:06:57.581939751Z",

        "finished_at": "2023-08-10T15:07:57.581939751Z",

        "duration_ms":  1000

    }

}

4. 常见问题

Q：如何找到Coginiti API开放平台

A：幂简集成是国内领先的API集成管理平台，专注于为开发者提供全面、高效、易用的API集成解决方案。幂简API平台可以通过以下两种方式找到所需API：通过关键词搜索API(例如，输入’Coginiti API开放平台‘这类品类词，更容易找到结果)、或者从API hub分类页进入寻找。

Q：使用API密钥无效？
A：登录您的仪表板并删除与 API 密钥关联的应用程序。请注意，所有使用此 API 密钥的应用程序/集成都将停止工作。

设置启用了MFA功能的Azure企业应用程序
设置IAM提供程序和角色

Q：Azure AD IdP租户?
A：Amazon Redshift应用程序的Azure AD租户ID（在IdP（Azure）上配置的公司租户名称）。

Q：Azure AD客户端ID？
A：使用Azure AD服务对连接进行身份验证时要使用的客户端ID（设置Azure SSO配置时创建的Amazon Redshift应用程序的带连字符的客户端ID）。

Q：如何重新安装Coginiti Pro？

A：1.使用Windows控制面板中的“添加或删除程序”删除Coginiti Pro。
2.转到Windows资源管理器，导航到C：/Users/username/AppData/Local/Aginity目录，并将aginity-pro重命名为OLD-aginity-pro。如果你愿意，我们可以恢复旧版本。如果你不想再使用它，就把它取下来。
3.重新配置应创建新版本用户文件的产品。

Q：Coginiti API开放平台的替代品有哪些？

除了Coginiti API开放平台，还有其他替代服务商也提供类似api服务，例如：

revocalize API开放平台、DesiVocal API开放平台、Speechify API开放平台

更多竞品可以在幂简集成开放平台中找到。

Q：Coginiti API开放平台这个密钥还适用于哪些api？

使用执行API、目录浏览API

5. 总结

本文全面而细致地介绍了获取Coginiti API开放平台密钥的完整流程，为开发者们提供了一份条理清晰、易于操作的分步指南。从Coginiti API平台的账号注册，到开发者身份验证的顺利完成，再到API服务密钥的成功获取，每一步操作都配以详尽的说明与指导，确保开发者能够轻松、准确地完成整个流程。本文特别强调了进行可用性测试的重要性，这不仅有助于开发者了解API的性能和稳定性，更是确保API能够顺利集成到应用中并发挥最佳效果的关键一步。通过测试，开发者可以及时发现并解决潜在的问题，从而提升应用的性能和用户体验。本文为开发者们提供了一个全面、详尽且极具实用价值的操作指南，帮助他们顺利获取Coginiti API开放平台的密钥，并将这一强大的数据处理能力有效地集成到应用中。我们相信，随着开发者们对这一指南的深入理解和实践，将能够充分利用Coginiti API的优势，为应用的智能化、高效化发展注入新的动力，进一步推动数字创新和应用升级。