115 lines
3.7 KiB
Markdown
115 lines
3.7 KiB
Markdown
---
|
|
title: Application
|
|
description: 表示一个通过 REST API 访问帐户或发布嘟文的应用。
|
|
menu:
|
|
docs:
|
|
parent: entities
|
|
aliases: [
|
|
"/entities/application",
|
|
"/entities/Application",
|
|
"/api/entities/application",
|
|
"/api/entities/Application",
|
|
]
|
|
---
|
|
|
|
## 示例
|
|
|
|
```json
|
|
{
|
|
"name": "Test Application",
|
|
"website": "https://app.example",
|
|
"scopes": ["read", "write", "push"],
|
|
"redirect_uri": "https://app.example/callback\nhttps://app.example/register",
|
|
"redirect_uris": [
|
|
"https://app.example/callback",
|
|
"https://app.example/register"
|
|
]
|
|
}
|
|
```
|
|
|
|
## 属性
|
|
|
|
### `name` {#name}
|
|
|
|
**描述:** 你的应用的名称。\
|
|
**类型:** 字符串\
|
|
**版本历史:**\
|
|
0.9.9 - 添加
|
|
|
|
### `website` {{%optional%}} {#website}
|
|
|
|
**描述:** 与你的应用关联的网站。\
|
|
**类型:** {{<nullable>}} 字符串 (URL)\
|
|
**版本历史:**\
|
|
0.9.9 - 添加\
|
|
3.5.1 - this property is now nullable
|
|
|
|
### `scopes` {#scopes}
|
|
|
|
**描述:** 你的应用的作用域。按空格分隔的已注册的 `scopes` 字符串。\
|
|
**类型:** 字符串数组\
|
|
**版本历史:**\
|
|
4.3.0 - 添加
|
|
|
|
### `redirect_uris` {#redirect_uris}
|
|
|
|
**描述:** 你的应用的已注册重定向 URI。\
|
|
**类型:** 字符串数组 (数组中元素的值为 URL 或 `"urn:ietf:wg:oauth:2.0:oob"`)\
|
|
**版本历史:**\
|
|
4.3.0 - 添加
|
|
|
|
### `redirect_uri` {{%deprecated%}} {#redirect_uri}
|
|
|
|
**描述:** 你的应用的已注册重定向 URI。\
|
|
当注册了多个重定向 URI 时，可能包含 `\n` 字符。\
|
|
**类型:** 字符串\
|
|
**版本历史:**\
|
|
0.0.0 - 添加\
|
|
4.3.0 - 已弃用，推荐使用 [`redirect_uris`]({{< relref "entities/Application#redirect_uris" >}})，因为当注册了多个重定向 URI 时，此属性的值不是一个格式规范的 URI
|
|
|
|
### `vapid_key` {{%deprecated%}} {#vapid_key}
|
|
|
|
**描述:** 用于流式推送 API。与 [POST /api/v1/apps]({{< relref "methods/apps#create" >}}) 一同返回。等同于 [WebPushSubscription#server_key]({{< relref "entities/WebPushSubscription#server_key" >}}) 和 [Instance#vapid_public_key]({{< relref "entities/Instance#vapid_public_key" >}})\
|
|
**类型:** 字符串\
|
|
**版本历史:**\
|
|
2.8.0 - 添加\
|
|
4.3.0 - 已弃用，等待移除，请参阅 [api/v2/instance]({{< relref "methods/Instance#v2">}}) 以获取此值 (`configuration.vapid.public_key`)
|
|
|
|
## CredentialApplication 属性 {#CredentialApplication}
|
|
|
|
所有 [Application](#attributes) 属性以及以下属性：
|
|
|
|
### `client_id` {#client_id}
|
|
|
|
**描述:** 客户端 ID 密钥，用于获取 OAuth 令牌\
|
|
**类型:** 字符串\
|
|
**版本历史:**\
|
|
0.9.9 - 添加
|
|
4.3.0 - moved to `CredentialApplication` from `Application`
|
|
|
|
### `client_secret` {#client_secret}
|
|
|
|
**描述:** 客户端密钥，用于获取 OAuth 令牌\
|
|
**类型:** 字符串\
|
|
**版本历史:**\
|
|
0.9.9 - 添加
|
|
4.3.0 - moved to `CredentialApplication` from `Application`
|
|
|
|
### `client_secret_expires_at` {#client_secret_expires_at}
|
|
|
|
**描述:** 客户端密钥到期时间，目前始终返回 `0`，表示 OAuth 客户端不会过期\
|
|
**类型:** 字符串\
|
|
**版本历史:**\
|
|
4.3.0 - 添加
|
|
|
|
## 参见
|
|
|
|
{{< page-relref ref="methods/apps" caption="应用 API 方法" >}}
|
|
|
|
{{< page-relref ref="entities/Status#application" caption="嘟文（`application` 属性）" >}}
|
|
|
|
{{< caption-link url="https://github.com/mastodon/mastodon/blob/main/app/serializers/rest/application_serializer.rb" caption="app/serializers/rest/application_serializer.rb" >}}
|
|
|
|
{{< caption-link url="https://github.com/mastodon/mastodon/blob/main/app/serializers/rest/credential_application_serializer.rb" caption="app/serializers/rest/credential_application_serializer.rb" >}}
|
|
|
|
{{< translation-status-zh-cn raw_title="Application" raw_link="/entities/Application/" last_translation_time="2025-04-21" raw_commit="6addd5cf525adec1859f48c52dafcfe1f96e558a">}}
|