npm 包 @workplus/isv-client 使用教程

阅读时长 4 分钟读完

介绍

@workplus/isv-client 是企业级移动应用开发平台 WorkPlus 提供的一个用于集成企业信息化系统的 ISV 客户端。该客户端提供了一系列 API,开发者可以在移动端应用中调用这些 API 来获取企业信息化系统的数据,实现与企业信息化系统的无缝集成,提升移动应用的体验和功能。

安装

你可以使用 npm 来安装 @workplus/isv-client:

使用方法

初始化

在使用客户端之前,你需要通过 WorkPlus 管理后台申请到 client_id 和 client_secret。这些参数将用于验证应用的身份以及获取数据时的身份鉴权。

管理后台注册 ISV 应用

  1. 进入 WorkPlus 管理后台,在「安全中心」-「开发者中心」页面下,注册应用。

  2. 点击「新增应用」按钮,填写应用名称、描述、logo 等信息,保存后即可获取对应的 client_id 和 client_secret。

在项目中使用

在项目中引入 @workplus/isv-client 依赖:

然后实例化 WorkPlus:

在实例化 WorkPlus 后,我们就可以通过 WorkPlus 实例来调用 ISV 客户端提供的 API。

API

获取认证密钥

该方法用于获取认证密钥,密钥用于后续 API 调用的身份鉴权。options 参数支持以下属性:

  • url: 企业信息化系统认证接口地址。
  • username: 认证用户的用户名。
  • password: 认证用户的密码。
  • grantType: 授权类型,默认为 password。

获取用户信息

该方法用于获取当前用户的信息。options 参数支持以下属性:

  • url: 企业信息化系统认证接口地址。
  • authToken: 身份认证 Token。

获取部门列表

该方法用于获取当前用户所属企业的部门列表。options 参数支持以下属性:

  • url: 企业信息化系统接口地址。
  • authToken: 身份认证 Token。

示例代码

下面是一些示例代码,展示了如何使用 @workplus/isv-client 客户端来调用 API。

-- -------------------- ---- -------
------ -------- ---- -----------------------

----- -------- ------ -
  ----- -------- - --- ----------
    --------- ---
    ------------- ---
  ---

  ----- -------- - ----- ----------------------
    ---- ---------------------------
    --------- -----------
    --------- -----------
  ---

  ----- -------- - ----- ----------------------
    ---- ---------------------------
    ---------- ----------------------
  ---

  ----- -------------- - ----- ----------------------------
    ---- ---------------------------
    ---------- ----------------------
  ---

  ---------------------- -- ----------
  ---------------------- -- ----------
  ---------------------------- -- ----------------
-

结论

@workplus/isv-client 是一个非常有用的客户端,它提供了一系列可以帮助我们在移动应用中集成企业信息化系统的 API。如果你在开发中需要集成企业信息化系统,那么你一定不要错过这个客户端。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/60065f8d238a385564ab6ec2

纠错
反馈