인증
모든 요청에는 API 키나 OAuth 액세스 토큰이 필요합니다. 직접 호출할 때는 API 키를 사용하고, MCP로 연결한 AI 앱은 OAuth 액세스 토큰을 사용합니다.
API 키
Authorization 헤더에 Bearer 토큰으로 키를 보냅니다.
Authorization: Bearer YOUR_API_KEY
- 키는 콘솔에서 생성하고, 재발급하고, 삭제합니다.
- 워크스페이스 소유자, 관리자, 멤버가 키를 생성할 수 있습니다.
- 키는 하나의 워크스페이스에 속하며 그 워크스페이스에만 접근합니다.
- 키는 내 역할로 동작하며, 키에 부여한 API 권한 안에서만 사용할 수 있습니다.
주의
키가 외부에 노출되지 않도록 보관해야 합니다. 키가 노출되면 바로 재발급하거나 삭제해야 합니다.
OAuth 액세스 토큰
MCP로 AI 앱을 연결하면 앱은 API 키 대신 OAuth 액세스 토큰을 받습니다. 토큰은 API 키와 같이 동작합니다. 선택한 워크스페이스에 속하고, 승인한 API 권한을 가집니다. 토큰을 보내고 갱신하는 일은 앱이 처리합니다.
자격 증명 확인
Ping은 보낸 API 키나 OAuth 액세스 토큰의 워크스페이스와 API 권한을 반환합니다.