본문으로 건너뛰기

계정 상태 API

이 페이지에서는 디바이스 온라인/오프라인 상태, 로그인 상태, 태그를 포함하여 TikMatrix에서 관리하는 모든 계정의 상태를 조회하는 API 엔드포인트를 설명합니다.

계정 목록​

확장된 상태 정보와 함께 모든 계정을 가져옵니다.

  • 엔드포인트: GET /api/v1/accounts

쿼리 매개변수​

매개변수유형기본값설명
platformstring—플랫폼으로 필터링: tiktok 또는 instagram
devicestring—디바이스 시리얼 번호로 필터링
loginedinteger—로그인 상태로 필터링: 0 = 로그인되지 않음, 1 = 로그인됨
statusinteger—계정 상태로 필터링: 0 = 활성화됨, 1 = 비활성화됨
tagstring—태그로 필터링(정확히 일치)
pageinteger1페이지 번호(1부터 시작)
page_sizeinteger20페이지당 항목 수(최대 100)

응답 필드​

필드유형설명
accountsarray계정 객체 목록(아래 참조)
totalinteger필터와 일치하는 총 계정 수
pageinteger현재 페이지 번호
page_sizeinteger페이지당 항목 수

계정 객체​

필드유형설명
idinteger계정 데이터베이스 ID
usernamestring | null소셜 미디어 사용자 이름
emailstring | null계정 이메일 주소
platformstring플랫폼: tiktok 또는 instagram
packagenamestring | null복제 앱 패키지 이름(null = 기본 앱)
devicestring | nullADB 디바이스 시리얼 번호
device_onlineboolean디바이스가 현재 연결되어 있는지 여부
device_namestring디바이스 모델 이름(오프라인일 때는 빈 문자열)
loginedinteger0 = 로그인되지 않음, 1 = 로그인됨
logined_textstring"logged_in" 또는 "not_logged_in"
statusinteger0 = 활성화됨, 1 = 비활성화됨
status_textstring"enabled" 또는 "disabled"
tagsstring[]이 계정에 할당된 태그
보안

계정 비밀번호는 API 응답에 절대 포함되지 않습니다.

예제​

curl "http://localhost:50809/api/v1/accounts?page=1&page_size=20"

플랫폼과 로그인 상태로 필터링:

curl "http://localhost:50809/api/v1/accounts?platform=tiktok&logined=1&page=1&page_size=50"

디바이스 시리얼 번호로 필터링:

curl "http://localhost:50809/api/v1/accounts?device=emulator-5554"

샘플 응답​

{
  "code": 0,
  "message": "success",
  "data": {
    "accounts": [
      {
        "id": 1,
        "username": "my_tiktok_user",
        "email": "user@example.com",
        "platform": "tiktok",
        "packagename": null,
        "device": "emulator-5554",
        "device_online": true,
        "device_name": "sdk_gphone64_x86_64",
        "logined": 1,
        "logined_text": "logged_in",
        "status": 0,
        "status_text": "enabled",
        "tags": ["batch-a", "vip"]
      },
      {
        "id": 2,
        "username": "another_user",
        "email": null,
        "platform": "tiktok",
        "packagename": "com.zhiliaoapp.musically.clone1",
        "device": "192.168.1.101:5555",
        "device_online": false,
        "device_name": "",
        "logined": 0,
        "logined_text": "not_logged_in",
        "status": 1,
        "status_text": "disabled",
        "tags": []
      }
    ],
    "total": 2,
    "page": 1,
    "page_size": 20
  }
}

오류 응답​

HTTP 상태코드설명
40340301금지됨 — API 액세스에는 Pro+ 플랜이 필요합니다
50050001내부 서버 오류