refactor: Update API documentation and curl examples with protocol-aware URLs

This commit is contained in:
beilunyang
2025-02-10 11:51:47 +08:00
parent e23e8170b9
commit 5454d1a7b2
2 changed files with 15 additions and 22 deletions

View File

@@ -411,33 +411,26 @@ Content-Type: application/json
#### 获取邮箱列表
```http
GET /api/emails?cursor=xxx&limit=10
GET /api/emails?cursor=xxx
```
参数说明:
- `cursor`: 分页游标,可选
- `limit`: 每页数量,默认 10
#### 获取单个邮箱
#### 获取指定邮箱邮件列表
```http
GET /api/emails/{emailId}
GET /api/emails/{emailId}?cursor=xxx
```
参数说明:
- `cursor`: 分页游标,可选
#### 删除邮箱
```http
DELETE /api/emails/{emailId}
```
#### 获取邮件列表
#### 获取单封邮件内容
```http
GET /api/emails/{emailId}/messages?cursor=xxx&limit=10
```
参数说明:
- `cursor`: 分页游标,可选
- `limit`: 每页数量,默认 10
#### 获取单封邮件
```http
GET /api/emails/{emailId}/messages/{messageId}
GET /api/emails/{emailId}/{messageId}
```
### 使用示例

View File

@@ -324,7 +324,7 @@ export function ApiKeyPanel() {
variant="ghost"
size="icon"
onClick={() => copyToClipboard(
`curl -X POST https://${window.location.host}/api/emails/generate \\
`curl -X POST ${window.location.protocol}//${window.location.host}/api/emails/generate \\
-H "X-API-Key: YOUR_API_KEY" \\
-H "Content-Type: application/json" \\
-d '{
@@ -338,7 +338,7 @@ export function ApiKeyPanel() {
</Button>
</div>
<pre className="text-xs bg-muted/50 rounded-lg p-4 overflow-x-auto">
{`curl -X POST https://${window.location.host}/api/emails/generate \\
{`curl -X POST ${window.location.protocol}//${window.location.host}/api/emails/generate \\
-H "X-API-Key: YOUR_API_KEY" \\
-H "Content-Type: application/json" \\
-d '{
@@ -356,7 +356,7 @@ export function ApiKeyPanel() {
variant="ghost"
size="icon"
onClick={() => copyToClipboard(
`curl https://${window.location.host}/api/emails?cursor=CURSOR \\
`curl ${window.location.protocol}//${window.location.host}/api/emails?cursor=CURSOR \\
-H "X-API-Key: YOUR_API_KEY"`
)}
>
@@ -364,7 +364,7 @@ export function ApiKeyPanel() {
</Button>
</div>
<pre className="text-xs bg-muted/50 rounded-lg p-4 overflow-x-auto">
{`curl https://${window.location.host}/api/emails?cursor=CURSOR \\
{`curl ${window.location.protocol}//${window.location.host}/api/emails?cursor=CURSOR \\
-H "X-API-Key: YOUR_API_KEY"`}
</pre>
</div>
@@ -376,7 +376,7 @@ export function ApiKeyPanel() {
variant="ghost"
size="icon"
onClick={() => copyToClipboard(
`curl https://${window.location.host}/api/emails/{emailId}/messages?cursor=CURSOR \\
`curl ${window.location.protocol}//${window.location.host}/api/emails/{emailId}?cursor=CURSOR \\
-H "X-API-Key: YOUR_API_KEY"`
)}
>
@@ -384,7 +384,7 @@ export function ApiKeyPanel() {
</Button>
</div>
<pre className="text-xs bg-muted/50 rounded-lg p-4 overflow-x-auto">
{`curl https://${window.location.host}/api/emails/{emailId}/messages?cursor=CURSOR \\
{`curl ${window.location.protocol}//${window.location.host}/api/emails/{emailId}?cursor=CURSOR \\
-H "X-API-Key: YOUR_API_KEY"`}
</pre>
</div>
@@ -396,7 +396,7 @@ export function ApiKeyPanel() {
variant="ghost"
size="icon"
onClick={() => copyToClipboard(
`curl https://${window.location.host}/api/emails/{emailId}/{messageId} \\
`curl ${window.location.protocol}//${window.location.host}/api/emails/{emailId}/{messageId} \\
-H "X-API-Key: YOUR_API_KEY"`
)}
>
@@ -404,7 +404,7 @@ export function ApiKeyPanel() {
</Button>
</div>
<pre className="text-xs bg-muted/50 rounded-lg p-4 overflow-x-auto">
{`curl https://${window.location.host}/api/emails/{emailId}/{messageId} \\
{`curl ${window.location.protocol}//${window.location.host}/api/emails/{emailId}/{messageId} \\
-H "X-API-Key: YOUR_API_KEY"`}
</pre>
</div>