# General Translation Platform: 获取项目详情
URL: https://generaltranslation.com/zh/docs/platform/openapi/reference/project/project-info.mdx
---

title: 获取项目详情
description: 读取 General Translation 项目的元数据、设置和配置详情。用于获取项目详情的 API 参考。

method: GET
---

返回项目的核心元数据和区域设置。路径中的项目 ID 必须与已通过身份验证的项目一致。

## 概览 [#overview]

```http
GET https://api2.gtx.dev/v2/project/info/:projectId
```

**权限** `project:files:read` · **速率限制** 默认 (200/分钟) 

读取项目名称、区域设置和设置。要更改默认区域设置，请使用[更新项目信息](/docs/platform/openapi/reference/project/update-project)。

## 工作原理 [#how-it-works]

* 路径中的 `projectId` 必须与该 API 密钥所对应的项目一致。如果 ID 缺失或不匹配，则会返回 `400`。
* 响应中包含项目名称、组织 ID、默认和当前区域设置，以及是否已启用自动审批。

## 请求 [#request]

### 请求头

| 请求头               | 描述                           | 必填 |
| ----------------- | ---------------------------- | -- |
| `x-gt-api-key`    | 项目或 Organization 的 API 密钥。   | 是  |
| `x-gt-project-id` | 项目 ID。使用 Organization 密钥时必填。 | 否  |

### 路径参数

| 参数          | 描述                   | 类型       | 必填 |
| ----------- | -------------------- | -------- | -- |
| `projectId` | 项目 ID；必须与当前已认证的项目匹配。 | `string` | 是  |

## 响应 [#response]

**状态** `200 OK`

```json title="Response"
{
  "id": "prj_...",
  "name": "My Project",
  "orgId": "org_...",
  "defaultLocale": "en",
  "currentLocales": ["es", "fr"],
  "autoApprove": false
}
```

## 错误 [#errors]

| 状态    | 原因                                |
| ----- | --------------------------------- |
| `400` | 缺少 `projectId`，或其与已认证的项目不匹配。      |
| `401` | 缺少 API 密钥，或 API 密钥无效。             |
| `403` | API 密钥没有 `project:files:read` 权限。 |
| `429` | 超出速率限制。                           |

## 示例 [#example]

```bash
curl -X GET https://api2.gtx.dev/v2/project/info/prj_... \
  -H "x-gt-api-key: gtx-api-..."
```