앱

이 플러그인을 설치하는 단계와 전체 마크다운 가이드를 포함한 설치 명령어를 복사합니다.

Apps are the foundational entities in Capgo. Each app represents a unique Capacitor application that you can manage and update through the platform. The Apps API allows you to create, retrieve, update, and delete app configurations.

앱 이해하기 섹션

Capgo은 Capacitor 애플리케이션을 나타내며, 다음과 같은 구성 요소를 포함합니다.

__CAPGO_KEEP_0__ ID__CAPGO_KEEP_1__ : __CAPGO_KEEP_0__
__CAPGO_KEEP_2____CAPGO_KEEP_3__ : __CAPGO_KEEP_2__
__CAPGO_KEEP_4____CAPGO_KEEP_5__ : __CAPGO_KEEP_4__
__CAPGO_KEEP_6____CAPGO_KEEP_7__ : __CAPGO_KEEP_6__
__CAPGO_KEEP_8____CAPGO_KEEP_9__ : __CAPGO_KEEP_8__
__CAPGO_KEEP_10____CAPGO_KEEP_11__ : __CAPGO_KEEP_10__

최선의 관행

이름 규칙: 앱에 명확하고 식별 가능한 이름을 사용하세요
보안: Protect your API keys and access credentials
: __CAPGO_KEEP_0__ 키와 접근 자격 증명을 보호하세요단체
: 관련 앱을 동일한 단체 아래에 그룹화하세요모니터링
: 앱 통계 및 성능을 정기적으로 확인하세요백업

API 포인트

GET

https://api.capgo.app/app/

앱 정보를 가져옵니다.

쿼리 매개변수

page페이지 번호 (선택 사항)
limit페이지당 결과 수 (기본값: 50, 선택 사항)
org_id조직 ID로 앱을 필터링합니다. (기본값: 사용자가 접근 가능한 모든 조직의 앱)

특정 앱을 가져오려면

URL 경로에 앱 ID를 사용하세요. https://api.capgo.app/app/:app_id

응답 유형

주의: last_version 앱에 업로드 된 마지막 번들(버전)에 대한 참조입니다.

interface App {
  app_id: string
  block_provider_infra_requests: boolean
  created_at: string | null
  default_upload_channel: string
  icon_url: string
  id: string | null
  last_version: string | null // last bundle (version) name
  name: string | null
  owner_org: string
  retention: number
  transfer_history: Json[] | null
  updated_at: string | null
  user_id: string | null
}

예시 요청

# Get all apps
curl -H "authorization: your-api-key" \
  "https://api.capgo.app/app/"

# Get apps from a specific organization
curl -H "authorization: your-api-key" \
  "https://api.capgo.app/app/?org_id=046a36ac-e03c-4590-9257-bd6c9dba9ee8"

# Get specific app
curl -H "authorization: your-api-key" \
  "https://api.capgo.app/app/com.demo.app"

예시 응답 섹션

{
  "data": [
    {
      "block_provider_infra_requests": true,
      "app_id": "com.demo.app",
      "created_at": "2024-01-01T00:00:00Z",
      "default_upload_channel": "dev",
      "icon_url": "https://example.com/icon.png",
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "last_version": "1.0.0",
      "name": "Demo App",
      "owner_org": "046a36ac-e03c-4590-9257-bd6c9dba9ee8",
      "retention": 2592000,
      "transfer_history": null,
      "updated_at": "2024-01-01T00:00:00Z",
      "user_id": "6aa76066-55ef-4238-ade6-0b32334a4097"
    }
  ]
}

POST

https://api.capgo.app/app/

새로운 앱을 만들기

요청 본문

interface CreateApp {
  app_id: string
  name: string
  icon?: string
  owner_org: string
}

예시 요청

# Create new app
curl -X POST \
  -H "authorization: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My New App",
    "app_id": "com.demo.myapp", // this id is unique in Capgo This cannot be reused by any account.
    "icon": "https://example.com/icon.png",
    "owner_org": "046a36ac-e03c-4590-9257-bd6c9dba9ee8"
  }' \
  https://api.capgo.app/app/

성공 응답

{
  "block_provider_infra_requests": true,
  "app_id": "My New App",
  "created_at": "2024-01-01T00:00:00Z",
  "default_upload_channel": "dev",
  "icon_url": "https://example.com/icon.png",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "My New App",
  "owner_org": "046a36ac-e03c-4590-9257-bd6c9dba9ee8",
  "retention": 2592000,
  "updated_at": "2024-01-01T00:00:00Z"
}

PUT

https://api.capgo.app/app/:app_id

기존 앱을 업데이트합니다. URL 경로에 앱 ID가 지정됩니다.

요청 본문

interface UpdateApp {
  block_provider_infra_requests?: boolean
  name?: string
  icon?: string
  retention?: number
}

예제 요청

curl -X PUT \
  -H "authorization: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "block_provider_infra_requests": true,
    "name": "Updated App Name",
    "icon": "https://example.com/updated-icon.png",
    "retention": 45
  }' \
  https://api.capgo.app/app/com.demo.app

성공 응답

{
  "app_id": "com.demo.app",
  "created_at": "2024-01-01T00:00:00Z",
  "default_upload_channel": "dev",
  "block_provider_infra_requests": true,
  "icon_url": "https://example.com/updated-icon.png",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Updated App Name",
  "owner_org": "046a36ac-e03c-4590-9257-bd6c9dba9ee8",
  "retention": 45,
  "updated_at": "2024-01-01T00:00:00Z"
}

DELETE

https://api.capgo.app/app/:app_id

앱과 관련된 모든 리소스를 삭제합니다. 앱 ID는 URL 경로에 지정됩니다. 이 작업은 되돌릴 수 없으므로极度 주의가 필요합니다.

예제 요청

curl -X DELETE \
  -H "authorization: your-api-key" \
  https://api.capgo.app/app/com.demo.app

클립보드 복사

{
  "status": "ok"
}

오류 처리

일반적인 오류 상황과 그에 대한 응답:

// App not found
{
  "error": "App not found",
  "status": "KO"
}

// Duplicate custom ID
{
  "error": "Custom ID already in use",
  "status": "KO"
}

// Invalid parameters
{
  "error": "Invalid app configuration",
  "status": "KO"
}

// Permission denied
{
  "error": "Insufficient permissions to manage app",
  "status": "KO"
}

// Organization access denied
{
  "status": "You do not have access to this organization"
}

일반적인 사용 사례

새 앱 만들기

// Set up a new app
{
  "name": "Production App",
  "owner_org": "046a36ac-e03c-4590-9257-bd6c9dba9ee8"
}

앱 구성 업데이트

// Change app name and icon
{
  "name": "Rebranded App Name",
  "icon": "https://example.com/new-icon.png"
}

보관 정책 설정

// Configure automatic bundle cleanup
{
  "retention": 30 // Keep bundles for 30 days
}

회사별 앱 가져오기

# List all apps in a specific organization
curl -H "authorization: your-api-key" \
  "https://api.capgo.app/app/?org_id=046a36ac-e03c-4590-9257-bd6c9dba9ee8"

리소스 관리

저장소 최적화: 저장소 사용량 모니터링 및 적절한 보존 정책 설정
회사: 회사별로 관련 앱을 단일 회사로 그룹화
접근 제어: 팀 멤버가 앱 설정을 수정할 수 있는지 관리
백업 전략: 앱의 중요한 설정과 구성 정보를 백업하세요.

앱스에서 계속하세요.

Capgo에서 앱을 사용 중이라면 앱스 to plan dashboard and API operations, connect it with API Overview API 개요 __CAPGO_KEEP_0__ 개요 Capgo에서 __CAPGO_KEEP_0__ 개요 API Keys for the implementation detail in API Keys, 기기 기기 구현 세부 사항에 대한 패키지 패키지 구현 세부 사항에 대한