对于 AI 代理:可在 https://www.mongodb.com/zh-cn/docs/llms.txt 获取文档索引—通过在任何 URL 路径后添加 .md 可获取所有页面的 Markdown 版本。

生成服务帐户令牌

如果您使用服务帐户,则需要令牌才能向Atlas Administration API发出请求。 要学习;了解更多信息,请参阅服务帐户概述。

注意

IP访问列表应用于使用服务帐户访问权限令牌,而不是创建或撤销它们。您可以从任何IP生成令牌,但只有当您的IP位于访问权限列表上时,才能使用它来调用API。

POST https://cloud.mongodb.com/api/oauth/token

此端点不使用 HTTP 请求路径参数。

以下查询参数为可选参数:

名称
类型
必要性
说明
默认

pretty

布尔

Optional

false

envelope

布尔

Optional

指示是否将响应包装在信封中的标志。

某些 API 客户端无法访问 HTTP 响应标头或状态代码。要修复此问题,在查询中设置 envelope : true。

对于返回结果列表的端点,content对象是一个信封。Atlas将 status字段添加到响应正文。

false

此端点不使用 HTTP 请求正文参数。

响应包括:

名称
类型
说明

access_token

字符串

用于对API请求进行身份验证的服务帐户访问权限令牌。

token_type

字符串

令牌授权机制,在此处表示为 Bearer。

expires_in

整型

访问权限令牌的有效持续时间(以秒为单位)。

将以下示例中的 {BASE64-AUTH} 替换为经过基本 64 编码的服务账户客户端ID和密钥。要了解更多,请参阅 发出 API 请求。

curl --request POST \ --url https://cloud.mongodb.com/api/oauth/token \ --header 'accept: application/json' \ --header 'cache-control: no-cache' \ --header 'authorization: Basic {BASE64-AUTH}' \ --header 'content-type: application/x-www-form-urlencoded' \ --data 'grant_type=client_credentials'
HTTP/2 200 OKdate: {dateInUnixFormat}strict-transport-security: max-age=31536000; includeSubdomains;vary: Accept-Encodingcontent-type: application/vnd.atlas.{apiVersion}+json;charset=utf-8referrer-policy: strict-origin-when-cross-originx-permitted-cross-domain-policies: nonex-content-type-options: nosniffx-mongodb-service-version: gitHash={gitHash}; versionString={applicationVersion}x-frame-options: DENYcontent-length: {requestLengthInBytes}x-envoy-upstream-service-time: 44server: mdbws
{ "access_token":"eyJhbGciOiJFUzUxMiIsInR5cCI6IkpXVCIsImtpZCI6IjAwMDAwMDAwLTQwMDBtLTQ0MGEIXkY0IH4IMF84MGYMX2FtperB2miniFzHCJ9.eyJpc3MiOiJodHRwczUvYWxkZXYubW9uZ29kYi5jb20iLCJhdWQiOiJhcGk6Ly9hZG1pbiIsInN1YiI6ImZha2Vfc3ViX2lkXzAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwIiwic2lkIjoiZmFrZTNfaWRfMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwIiwic2Vzc2lvblN1YiI6ImZha2Vfc2lkXzAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwIIDmVlc1NX4adGVyaCBJRCJvbmcxISS8zdeD0pyQwMjNlIiwiYWN0b3JJZCI6ImZha2Vfc2lkXzAwMDAwMDAwMDAwMDOIi8wMDAwMDAwMCIsImlhdCI6MTIzNDU2Nzg5MCwiZXhwIjoxMjM0NTc0OTgwLCJqdGkiOiJmYWtlLWp0aS02MOwNDBQNDBdDOGhyES8xOTY1OGEtMDAwMDAwMDAwMDAwMDAwMDAwMGIwNjRGM3NifQ==.jmbo9d_fgfk32FGB423f09SF0kFSDFoQxh3j9FZ2", "expires_in":3600, "token_type":"Bearer"}