अकाउंट स्थिति API

यह पेज TikMatrix में प्रबंधित सभी अकाउंट्स की स्थिति पूछने के लिए API endpoint को दस्तावेज़ित करता है, जिसमें डिवाइस की ऑनलाइन/ऑफलाइन स्थिति, लॉगिन स्थिति और टैग शामिल हैं।

अकाउंट सूची

समृद्ध स्थिति जानकारी के साथ सभी अकाउंट प्राप्त करें।

• एंडपॉइंट: GET /api/v1/accounts

क्वेरी पैरामीटर

पैरामीटर	प्रकार	डिफ़ॉल्ट	विवरण
platform	string	—	प्लेटफ़ॉर्म के अनुसार फ़िल्टर करें: tiktok, instagram या threads
device	string	—	डिवाइस सीरियल नंबर के अनुसार फ़िल्टर करें
logined	integer	—	लॉगिन स्थिति के अनुसार फ़िल्टर करें: 0 = लॉगिन नहीं, 1 = लॉगिन है
status	integer	—	अकाउंट स्थिति के अनुसार फ़िल्टर करें: 0 = सक्षम, 1 = अक्षम
tag	string	—	टैग के अनुसार फ़िल्टर करें (सटीक मिलान)
page	integer	1	पेज नंबर (1 से शुरू)
page_size	integer	20	प्रति पेज आइटम (अधिकतम 100)

रिस्पॉन्स फ़ील्ड

फ़ील्ड	प्रकार	विवरण
accounts	array	अकाउंट ऑब्जेक्ट्स की सूची (नीचे देखें)
total	integer	फ़िल्टर से मेल खाने वाले अकाउंट्स की कुल संख्या
page	integer	वर्तमान पेज नंबर
page_size	integer	प्रति पेज आइटम

अकाउंट ऑब्जेक्ट

फ़ील्ड	प्रकार	विवरण
id	integer	अकाउंट डेटाबेस ID
username	string | null	सोशल मीडिया उपयोगकर्ता नाम
email	string | null	अकाउंट ईमेल पता
platform	string	प्लेटफ़ॉर्म: tiktok, instagram या threads
packagename	string | null	क्लोन ऐप पैकेज नाम (null = डिफ़ॉल्ट ऐप)
device	string | null	ADB डिवाइस सीरियल नंबर
device_online	boolean	क्या डिवाइस वर्तमान में कनेक्ट है
device_name	string	डिवाइस मॉडल नाम (ऑफलाइन होने पर खाली स्ट्रिंग)
logined	integer	0 = लॉगिन नहीं, 1 = लॉगिन है
logined_text	string	"logged_in" या "not_logged_in"
status	integer	0 = सक्षम, 1 = अक्षम
status_text	string	"enabled" या "disabled"
tags	string[]	इस अकाउंट को सौंपे गए टैग

सुरक्षा

अकाउंट पासवर्ड API responses में कभी भी शामिल नहीं किया जाता है।

उदाहरण

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 स्थिति	कोड	विवरण
403	40301	निषिद्ध — API एक्सेस के लिए Pro+ प्लान आवश्यक है
500	50001	आंतरिक सर्वर त्रुटि