__CAPGO_KEEP_0__

앱의 개별 설치를 관리하는 Capgo에 대한 장치가 있습니다. 장치 API는 장치, 버전, 채널 및 업데이트 상태를 추적하고 관리할 수 있습니다.

데이터 보존

장치 데이터는 90일 장치가 마지막으로 활동한 이후 Capgo에 연결하지 않은 장치가 자동으로 시스템에서 제거됩니다. 업데이트 확인을 위해 장치가 활성화되면 지속적으로 추적됩니다.

장치 이해

각 장치에는 고유한 특성과 상태가 있습니다:

• 플랫폼: iOS, Android, 또는 Electron
• 번들 (버전): 현재 번들 (버전) 및 네이티브 빌드 버전
• 환경: 운영중인 환경 또는 개발 환경, 에뮬레이터 또는 물리적 장치
• 채널: 현재 업데이트 채널 assignments
• 커스텀 ID: 사용자 지정 추적 목적으로 사용할 수 있는 옵션 식별자

Best Practices

1. __CAPGO_KEEP_0__ (버전) 추적__CAPGO_KEEP_0__ 기기를 업데이트율을 확인하기 위해 버전 추적
2. __CAPGO_KEEP_1__ 관리__CAPGO_KEEP_1__ 기기를 테스트 목적에 따라 적절한 채널에 할당
3. __CAPGO_KEEP_2__ 인식__CAPGO_KEEP_2__ 다양한 환경(프로덕션/개발/에뮬레이터)을 적절히 처리
4. __CAPGO_KEEP_3____CAPGO_KEEP_3__

__CAPGO_KEEP_4__

__CAPGO_KEEP_5__

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

특정 버전 또는 채널에 장치 연결

__CAPGO_KEEP_0__

interface DeviceLink {
  app_id: string
  device_id: string
  version_id?: string // bundle (version) name
  channel?: string    // channel name
}

예제 요청

curl -X POST \
  -H "authorization: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "app_id": "app_123",
    "device_id": "device_456",
    "channel": "beta"
  }' \
  https://api.capgo.app/device/

성공 응답

{
  "status": "ok"
}

GET

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

장치 정보를 가져옵니다. 커서 기반 페이징을 사용하여 대형 장치 목록의 효율적인 가져오기를 지원합니다.

Query Parameters

• app_id: 필요합니다. 앱의 ID
• device_id: 선택적. 단일 장치의 가져오기를 위해 특정 장치 ID
• cursor: 선택적. 이전 응답에서 커서
• limit: 선택적. 페이지당 장치 수 (기본값: 50)

Example Requests

# Get all devices (first page)
curl -H "authorization: your-api-key" \
  "https://api.capgo.app/device/?app_id=app_123"

# Get specific device
curl -H "authorization: your-api-key" \
  "https://api.capgo.app/device/?app_id=app_123&device_id=device_456"

# Get next page using cursor
curl -H "authorization: your-api-key" \
  "https://api.capgo.app/device/?app_id=app_123&cursor=2024-01-01T00:00:00Z|device_456"

응답 유형 (목록)

다중 장치 요청 시 (파라미터 없음): device_id 클립보드 복사

interface DeviceListResponse {
  data: Device[];
  nextCursor?: string;  // Pass this as 'cursor' param to get next page
  hasMore: boolean;     // true if more pages available
}

interface Device {
  updated_at: string;
  device_id: string;
  custom_id: string;
  version?: number; // bundle (version) id
  version_name: string | null; // bundle (version) name
  channel?: string;
  app_id: string;
  platform: "ios" | "android" | "electron";
  plugin_version: string;
  os_version: string;
  version_build: string;
  is_prod: boolean;
  is_emulator: boolean;
  key_id: string | null; // First 4 chars of encryption key (e.g., "MIIB")
}

응답 유형 (단일 장치) 섹션

클립보드 복사 device_id 예시 응답 (목록)

interface Device {
  updated_at: string;
  device_id: string;
  custom_id: string;
  version?: number; // bundle (version) id
  version_name: string | null; // bundle (version) name
  channel?: string;
  app_id: string;
  platform: "ios" | "android" | "electron";
  plugin_version: string;
  os_version: string;
  version_build: string;
  is_prod: boolean;
  is_emulator: boolean;
  key_id: string | null; // First 4 chars of encryption key (e.g., "MIIB")
}

__CAPGO_KEEP_0__

{
  "data": [
    {
      "device_id": "device_456",
      "custom_id": "test-device-1",
      "version": 1,
      "version_name": "1.0.0",
      "app_id": "app_123",
      "platform": "ios",
      "plugin_version": "5.0.0",
      "os_version": "17.0",
      "version_build": "1",
      "is_prod": true,
      "is_emulator": false,
      "updated_at": "2024-01-01T00:00:00Z"
    }
  ],
  "nextCursor": "2024-01-01T00:00:00Z|device_456",
  "hasMore": true
}

예시 응답 (단일 기기)

{
  "device_id": "device_456",
  "custom_id": "test-device-1",
  "version": 1,
  "version_name": "1.0.0",
  "app_id": "app_123",
  "platform": "ios",
  "plugin_version": "5.0.0",
  "os_version": "17.0",
  "version_build": "1",
  "is_prod": true,
  "is_emulator": false,
  "updated_at": "2024-01-01T00:00:00Z",
  "channel": "production"
}

DELETE

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

기기 채널 오버라이드에서 기기를 해제합니다. 이로 인해 기기는 기본 채널을 사용하도록 다시 설정됩니다.

기기 삭제

기기 데이터는 90일 기기 활동이 마지막으로 발생한 이후에 보관됩니다. Capgo와 연결되지 않은 기기들은 이 기간 내에 자동으로 시스템에서 제거됩니다. 업데이트 확인을 위해 기기가 지속적으로 추적됩니다. 이 엔드포인트는 기기를 삭제할 수 없습니다. 채널 오버라이드만 영향을 받습니다.

__CAPGO_KEEP_0__

interface Device {
  device_id: string
  app_id: string
}

__CAPGO_KEEP_3__

curl -X DELETE \
  -H "authorization: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "app_id": "app_123",
    "device_id": "device_456"
  }' \
  https://api.capgo.app/device/

__CAPGO_KEEP_7__

{
  "status": "ok"
}

__CAPGO_KEEP_10__

일반 오류 시나리오 및 응답:

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

// Invalid bundle (version)
{
  "error": "Version not found",
  "status": "KO"
}

// Invalid channel
{
  "error": "Channel not found",
  "status": "KO"
}

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

일반 사용 사례

1. 베타 장치 등록

{
  "app_id": "app_123",
  "device_id": "device_456",
  "channel": "beta"
}

2. 버전 오버라이드

{
  "app_id": "app_123",
  "device_id": "device_456",
  "version_id": "1.1.0"
}

3. 기본 채널으로 초기화

// Use DELETE endpoint to remove overrides

장치 관리에 대한 팁

1. Monitoring: Regularly check device status and bundle (version) distribution
2. Testing: Use custom IDs to identify test devices easily
3. Troubleshooting: Track device updates and channel assignments
4. Native Version Control: Monitor native app versions to ensure compatibility

Keep going from Devices

If you are using Devices __CAPGO_KEEP_0__ 채널 경로 설정 및 단계별 출시를 계획하고 연결하세요. __CAPGO_KEEP_0__ 채널 __CAPGO_KEEP_0__ 채널 구현 세부 사항에 대한 정보입니다. __CAPGO_KEEP_0__ 채널 구현 세부 사항에 대한 정보입니다. __CAPGO_KEEP_0__ 채널 구현 세부 사항에 대한 정보입니다. __CAPGO_KEEP_0__ 베타 테스트 솔루션 __CAPGO_KEEP_0__ 제품 워크플로우에 대한 베타 테스트 솔루션입니다. __CAPGO_KEEP_0__ 제품 워크플로우에 대한 버전 대상 솔루션입니다. __CAPGO_KEEP_0__ 페이지 편집하기. __CAPGO_KEEP_0__ __CAPGO_KEEP_0__