获取应用图标的 URL

aki发表于:2024年09月18日 15:57:34更新于:2024年09月24日 10:10:09

获取应用图标的 URL

获取应用图标的 URL。
该 API 是异步 API。
如果要同步处理,请参考以下文章。

函数

PC版/手机

kintone.app.getIcons()

参数

参数名类型必须说明
apps数组必须应用 ID 列表
最多可指定 100 个应用 ID。

返回值

返回kintone.Promise对象。
kintone.Promise成功时,返回包含以下元素的对象数组。

属性名称类型说明
app数值应用ID
url字符串图标 URL
URL 的格式在今后 kintone 升级时可能会发生变更。
不要保存 URL,而是在显示图片时通过 API 获取 URL。

可使用的页面

PC

可在应用设置页面和 kintone 系统管理页面之外的所有页面上使用。

手机

可在所有页面上使用。

代码范例

(async () => {
  const icons = await kintone.app.getIcons([1, 2]);
  console.log(icons);
  // [
  //   {
  //     app: 1,
  //     url: "应用 ID 为 1 的应用的图标 URL"
  //   },
  //   {
  //     app: 2,
  //     url: "应用 ID 为 2 的应用的图标 URL"
  //   }
  // ]
  const img = document.createElement('img');
  img.src = icons[0].url;
})();

注意事项

根据 cybozu.cn 服务条款第 22 条的规定,kintone 中自带的图标的知识产权归 Cybozu 及其供应商所有。
通过此 API 在kintone 自定义和插件中显示图标的目的仅限于:表示是同一个环境中的应用。