# 服务台开发指南
- [概述](#概述)
- [名词解释](#名词解释)
- [限流策略](#限流策略)
- [如何使用服务台API](#如何使用服务台API)
## 概述
服务台API是开放平台基于Lark服务台的知识库/工单/客服等功能模块开放的查看/创建/修改/删除等API，开发者可以基于这些API对服务台对应的功能模块进行操作。
## 名词解释
### 服务台
服务台是Lark为企业开发的一个集合内部智能服务号的平台，采用了智能客服和人工客服结合为企业服务的方式。企业员工可自助通过服务台解决疑问。
### 服务台 id
服务台 id是每个服务台的唯一标识

### 服务台 token
请求中加入服务台token，表示拥有和服务台负责人相同的权限（查看修改服务台实体）。详见：[服务台token](https://open.larksuite.com/document/ukTMukTMukTM/ugDOyYjL4gjM24CO4IjN)

### 知识库
在服务台知识库中，管理员可以添加问题分类及问题内容。当问题数量较多时，管理员可以通过批量上传添加问题。此外，管理员还可修改问题内容，修改及删除问题分类。被删除的问题会进入回收站，如有需要，可在 30 天内恢复删除的问题。

## 限流策略
默认使用开放平台默认限流，单个API如有不同，会在对应API文档中说明。

## 如何使用服务台API
### 1、申请企业服务台 API 授权
若应用尚未申请服务台API权限，需在开发者后台增加权限申请并提交审核。企业自建应用需要企业管理员在管理后台审核通过；暂不支持应用商店应用。

### 2、API鉴权
服务台API作为开放平台对外能力一部分，会检查tenant_access_token/user_access_token得到对应信息。
同时使用服务台token鉴权，方便服务台负责人管理，控制应用对单个服务台资源的访问，修改权限。

### 3、调用服务台API
调用相关服务台API 对服务台资源创建，修改，删除，获取。 请参考具体的API文档