仅适用于

Enterprise and Professional admins can create new applications to which enterprise users can subscribe. Admins can manage and distribute these applications to specified users. Admins can also create, view, and delete API keys for users in their company or enterprise. For individually owned and managed apps, see My Account Settings.

有关使用 Onshape 应用的更多信息，请参阅 Onshape API 开发者文档。

若要在 Onshape 中导航到您的“开发者”设置，请单击 Onshape 窗口右上角的帐户用户图标 (帐户用户图标)。这将打开一个下拉菜单。单击“公司/教室/企业”设置。

在页面左侧的列表中单击“开发者”：

Enterprise 设置：开发者

管理员可在本屏执行的操作

  • 无需访问 App Store 开发门户，即可在公司设置中创建内部应用程序。

  • 在内部管理应用程序。

  • 查看、创建和删除公司内任何人的 API 密钥。

  • 查看公司的 API 使用情况，有关 API 使用情况的更多信息，请参见“API 限制”。

  1. 单击 OAuth 应用程序链接：

    创建新的 OAuth 应用程序

  2. 单击“创建新 OAuth 应用程序”按钮：

    创建 OAuth 应用程序

  3. 按如下方式填写信息（请注意，屏幕上还提供了详细信息）：

    • 名称 - 向用户显示的应用程序的名称。

    • 主要格式 - 用于标识应用程序的唯一字符串，不向用户显示。

    • 摘要 - 有关应用程序的信息。

    • 重定向 URL - 验证后您被重定向到的 URL。

    • 类型 - 应用程序类型。选项包括集成云应用程序、互联云应用程序或互联桌面应用程序。

    • OAuth URL - 用于从 Onshape 应用程序页面启动 OAuth 流程的 URL。

    • 设置

      • 支持协作 - 在开发应用程序时检查您是否希望与其他用户协作。

    • 权限 - 请参阅下面的权限范围。

  4. 单击“创建应用程序。

  5. 使用“搜索成员”字段查找和选择要加入应用程序开发和/或测试的用户。

  6. 向用户提供允许访问应用程序的“授权应用程序”屏幕：

    授权应用程序

  7. 有关使用 OAuth 对应用程序进行身份验证的信息，请参阅 API 指南：身份验证。

  1. In your Developer settings, click OAuth applications.
  2. Click the name of the app to transfer.
  3. Click the Transfer ownership button on the Details tab. The Transfer dialog opens.

    Transfer app dialog

  4. Select an option to transfer the app to an individual, company, or enterprise.
  5. To transfer to an individual, enter the name or email of the new owner in the search field. To transfer ownership to a company or enterprise, select an option from the dropdown.
  6. Click Transfer Ownership. The application is removed from your OAuth apps list.
    • If the app was transferred to an individual, it appears in their Onshape Developer Portal.
    • If the app was transferred to a company or enterprise, it appears in their Developer Settings

Future API call consumption and billing will be attributed to the new owner. See API Limits for details.

所有提交到 Onshape 应用商店（Onshape 应用）的应用程序都必须遵循 API 指南：OAuth2 页面上的说明，并使用 OAuth2 进行授权。自动脚本（或不适用于 Onshape 应用商店的应用程序）可能会使用 OAuth2 或 API 密钥进行认证。OAuth2 允许应用程序代表用户调用 Onshape API；API 密钥只能代表生成 API 密钥的 Onshape 用户执行操作。

API 密钥是创建供个人使用的小型应用程序的有用方法，可让开发者避免 OAuth 工作流程的开销。

API 密钥用于对应用程序进行身份验证，而不是对用户进行身份验证。（OAuth2 通过确保用户有权访问 Onshape 来对应用程序和应用程序用户进行身份验证。）创建 API 密钥后，它仅在创建 API 密钥的堆栈中有效。在 companyName.onshape.com 上创建的 API 密钥无法在 cad.onshape.com 上运行。

与公司或企业无关的 API 密钥可通过“我的帐户 - 开发者”页面进行管理。

查看 API 密钥

  1. 在您的公司/课堂/企业开发者设置中，单击 API 密钥
  2. 查看公司可用的 API 密钥。
    开发者屏幕中列出的 API 密钥

创建 API 密钥

  1. 在您的公司/课堂/企业开发者设置中，单击 API 密钥
  2. 点击创建新的 API 密钥。
    创建新的 API 密钥屏幕
  3. 在“名称”字段中提供 API 密钥的名称。

  4. 将 API 密钥分配给公司中的某人。您可以在“用户”输入框中按姓名或电子邮件进行搜索。

  5. 选择密钥的权限。请参阅下面的权限范围。
  6. 单击“创建 API 密钥”按钮。

  7. 在弹出窗口中，复制显示的 API 密钥和密钥，将其保存在某个地方，然后单击“关闭”按钮。

    您将无法再次找到密钥，因此请将其保存在安全的地方！

    向用户显示的密钥

  8. 有关使用 API 密钥对应用程序进行身份验证的信息，请参阅 API 指南：认证。

删除 API 密钥

  1. 点击您要删除的 API 密钥右侧的 “X” 图标。
  2. 确认您要为所有用户删除此 API 密钥。此操作无法撤消。单击“删除”进行确认。
    删除 API 密钥

创建 OAuth 应用程序时可以使用以下权限范围：

  • 应用程序可以读取您的配置文件信息 (OAuth2ReadPII) - 选中以允许应用程序访问您的配置文件中的信息。

  • 应用程序可以读取您的文档 (OAuth2Read) - 选中以允许应用程序读取您的文档。

  • 应用程序可以写入您的文档 (OAuth2Write) - 选中以允许应用程序对您的文档进行写入访问。

  • 应用程序可以删除您的文档和工作区 (OAuth2Delete) - 选中以允许应用程序访问删除您的文档和工作区。

  • 应用程序可以代表您请求购买 (OAuth2Purchase) - 勾选此项以允许应用程序为您进行购买。

  • 应用程序可以代表您共享和取消共享文档 (OAuth2Share) - 选中此选项可允许应用程序共享和取消共享您的文档。