---
title: Archbee CLI 身份验证指南
slug: docs/cn/archbee-cli
createdAt: 2026-08-25T09:37:14.437Z
---

# 身份验证概述

大多数 Archbee CLI API 命令需要：

- `--api-key`
- `--doc-space-id`

示例：

```bash
archbee search-docs --api-key YOUR_API_KEY --doc-space-id YOUR_SPACE_ID
```

# API 密钥类型

## 空间 API 密钥

空间 API 密钥的作用范围仅限于单个文档空间。

您可以从以下位置生成它们：

```text
Space Settings → API keys
```

## 团队 API 密钥

团队 API 密钥以下列内容开头：

```text
abteam_
```

团队管理员可以从以下位置创建它们：

```text
Settings → Developer
```

团队 API 密钥可以访问多个空间。

# 何时需要 `--doc-space-id`

大多数命令即使在使用团队 API 密钥时，也需要提供 `--doc-space-id` 值。

示例：

```bash
archbee get-doc --api-key abteam_xxx --doc-space-id SPACE_ID
```

# 不需要 `--doc-space-id` 的命令

这些团队级命令仅使用团队 API 密钥即可运行：

- `导出`
- `显示规则`
- `创建空间`
- `上传`
- `列出文件`
- `删除文件`
- `移动文件`
- `替换文件`

# 只读 API 密钥

只读团队 API 密钥无法修改内容。

以下这类命令在使用只读密钥时将失败：

- `创建文档`
- `删除文档`
- `发布空间`
- `更新空间`

# 身份验证故障排除

## API 密钥无效

请验证：

- 密钥尚未过期
- 密钥属于正确的团队或空间
- 命令中没有多余的空格或引号

## 空间访问错误

请确保 API 密钥具有访问指定空间的权限。

## 命令权限被拒绝

对于更改数据的命令，请使用启用了写入权限的团队密钥。