MongoDB Atlas App Services 관리자 API
3.0

기본 URL

https://services.cloud.mongodb.com/api/admin/v3.0

EOL(End-of-Life) 알림

앱 서비스의 수명 종료(EOL)에 도달했습니다. Atlas Device Sync, SDK, 데이터 API, GraphQL, 정적 호스팅 및 HTTPS endpoints 9월에 수명 30 종료에2025 도달했습니다. 데이터베이스 트리거는 계속 사용할 수 있습니다.

이는 인증 및 사용자 관리, 기능, 유선 프로토콜 및 데이터 액세스 권한을 포함한 추가 App Service 기능에 영향을 미칩니다. 이러한 기능과 관련된 API 엔드포인트는 더 이상 사용되지 않습니다.

자세한 내용은 지원 중단 페이지( https://www.mongodb.com/ko-kr/docs/atlas/app-services/deprecation/)를 참조하세요.

API Overview

App Services 관리자 API를 사용하면 HTTPS를 통해 프로그래밍 방식으로 관리 작업을 수행할 수 있습니다. 여기에는 정의 및 구성 등의 작업이 포함됩니다.

앱 배포 & 보안
API & 엔드포인트
인증 & 사용자 관리
데이터 소스
Device Sync
환경
함수
로그
규칙
Schemas
정적 호스팅
트리거
사용량 & 청구 지표
Values & Secrets

관리자 API 애플리케이션 개발, 구성 및 배포서버 위한 것입니다. 관리자 API 로 구성한 기능을 사용하려면 클라이언트 애플리케이션을 앱 전용 HTTPS API 에 연결해야 합니다.

프로젝트 & 애플리케이션 ID

참고: 프로젝트 ID와 그룹 ID라는 용어는 서로 바꿔 사용할 수 있습니다.

Atlas App Services 관리자 API 엔드포인트의 경우 URL에 두 개의 매개변수를 포함해야 하는 경우가 많습니다.

Atlas 프로젝트 ID(그룹 ID라고도 함)
App Services 애플리케이션 ID

프로젝트 ID

프로젝트 ID는 MongoDB Atlas 대시보드 또는 MongoDB Atlas CLI에서 찾을 수 있습니다.

애플리케이션 ID

애플리케이션 ID 찾으려면 프로젝트의 앱 나열 엔드포인트에 요청 합니다. 이 요청 하려면 access_token 이(가) 필요합니다. 토큰 획득 방법을 학습 관리자 API 세션 액세스 토큰 가져오기를 참조하세요.

curl --request GET \
  --header 'Authorization: Bearer <access_token>' \
  https://services.cloud.mongodb.com/api/admin/v3.0/groups/{groupId}/apps

그러면 제공된 프로젝트/그룹의 각 App Services 앱을 설명하는 객체 목록이 반환됩니다. 관리자 API 요청의 경우 애플리케이션 ID는 client_app_id가 아니라 _id 필드의 ObjectId 값입니다.

[
  {
    "_id": "5997529e46224c6e42gb6dd9",
    "group_id": "57879f6cc4b32dbe440bb8c5",
    "domain_id": "5886619e46124e4c42fb5dd8",
    "client_app_id": "myapp-abcde",
    "name": "myapp",
    "location": "US-VA",
    "deployment_model": "GLOBAL",
    "last_used": 1615153544,
    "last_modified": 0,
    "product": "standard",
    "environment": ""
  }
]

관리자 API 세션 액세스 토큰 가져오기

App Services 관리자 API에 대한 모든 요청에는 MongoDB 클라우드 API에서 발급한 유효하고 만료되지 않은 액세스 토큰이 포함되어야 합니다. 베어러 인증 체계를 사용하여 각 요청의 Authorization 헤더에 이 토큰을 포함합니다.

토큰을 가져오려면 MongoDB Atlas에 유효한 MongoDB Atlas 프로그래밍 방식 API 키가 필요합니다.

API 키 쌍이 준비되면 인증 엔드포인트를 호출합니다.

curl --request POST \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --data '{"username": "<Public API Key>", "apiKey": "<Private API Key>"}' \
  https://services.cloud.mongodb.com/api/admin/v3.0/auth/providers/mongodb-cloud/login

인증이 성공하면 App Services는 JSON 응답 문서의 일부로 액세스 토큰을 반환합니다.

{
  "access_token": "<access_token>",
  "refresh_token": "<refresh_token>",
  "user_id": "<user_id>",
  "device_id": "<device_id>"
}

access_token 은 Admin API 와 상호 작용 수 있는 한시적 권한 부여 나타냅니다. 요청 인증하려면 베어러 토큰 Authorization 헤더에 토큰을 포함합니다.

Authorization: Bearer <access_token>

관리자 API 세션 액세스 토큰 새로 고침

세션 액세스 토큰은 발급된 후 30분 후에 만료됩니다. 로그인하면 응답에 새 액세스 토큰을 얻는 데 사용할 수 있는 refresh_token도 포함됩니다. 자격 증명을 사용하여 한 번만 로그인하면 되기 때문에 유용합니다. 그 후에는 새로 고침 토큰을 사용하여 토큰이 유효한 기간 동안 재인증할 수 있습니다.

기본적으로 새로 고침 토큰은 발행 후 60일 후에 만료됩니다. 새로 고침 토큰 만료를 최소 30분 또는 최대 5년으로 사용자 지정할 수 있습니다.

인증을 새로 고치고 새 access_token을 가져오려면 Authorization 헤더에 refresh_token을 사용하여 인증 세션 엔드포인트를 호출합니다.

curl --request POST \
  --header 'Authorization: Bearer <refresh_token>' \
  https://services.cloud.mongodb.com/api/admin/v3.0/auth/session

새로 고침 토큰이 유효한 경우 응답 본문에는 다음 30분 동안 유효한 새 access_token이 포함됩니다.

{
  "access_token": "<access_token>"
}

이 API 문서의 버전 3.0 입니다. 마지막 업데이트 는 9월 23, 2025입니다.

MongoDB Atlas App Services 관리자 API 3.0