मुख्य कंटेंट तक स्किप करें

स्थानीय API अवलोकन

स्क्रिप्ट अपडेट\nPro में Threads message, follow_back, scrape_users और repost सपोर्ट करता है; post में content_type = 2 केवल टेक्स्ट पोस्ट है। TikTok/Instagram पर standalone message उपलब्ध नहीं है, वहाँ Super Marketing उपयोग करें।\n:::

TikMatrix एक स्थानीय RESTful API प्रदान करता है जो आपको कार्यों को प्रोग्रामेटिक रूप से प्रबंधित करने की अनुमति देता है। यह TikMatrix को अपने स्वयं के स्वचालन सिस्टम में एकीकृत करने, कस्टम वर्कफ़्लो बनाने या बैच संचालन करने के लिए उपयोगी है।

आवश्यकताएं​

लाइसेंस आवश्यकता

स्थानीय API केवल Pro, Team और Business योजना उपयोगकर्ताओं के लिए उपलब्ध है। Starter योजना API पहुंच प्रदान नहीं करती है।

बेस URL​

API स्थानीय रूप से चलता है, पता है:

http://localhost:50809/api/v1/
note

पोर्ट 50809 डिफ़ॉल्ट पोर्ट है। कृपया अनुरोध करने से पहले सुनिश्चित करें कि TikMatrix चल रहा है।

प्रतिक्रिया प्रारूप​

सभी API प्रतिक्रियाएं निम्नलिखित प्रारूप का पालन करती हैं:

{
  "code": 0,
  "message": "success",
  "data": { ... }
}

प्रतिक्रिया कोड विवरण​

Codeविवरण
0सफल
40001गलत अनुरोध - अमान्य पैरामीटर, जिसमें ऐसा script_config भी शामिल है जो सत्यापन में विफल हो
40002पैरामीटर त्रुटि - script_name गायब है
40003गलत अनुरोध - इस बिल्ड या प्लेटफ़ॉर्म पर स्क्रिप्ट समर्थित नहीं, कोई कार्यान्वयन नहीं, या टास्क की स्थिति अमान्य
40004पैरामीटर त्रुटि - केवल चल रहे कार्य को रोका जा सकता है
40005पैरामीटर त्रुटि - task_ids खाली नहीं हो सकता
40301निषिद्ध - API पहुंच के लिए Pro+ योजना की आवश्यकता है
40401नहीं मिला - संसाधन मौजूद नहीं है
50001सर्वर आंतरिक त्रुटि

त्वरित प्रारंभ​

1. API पहुंच की जांच करें​

सबसे पहले, पुष्टि करें कि आपका लाइसेंस API का समर्थन करता है:

curl http://localhost:50809/api/v1/license/check

नमूना प्रतिक्रिया:

{
  "code": 0,
  "message": "success",
  "data": {
    "plan_name": "Pro",
    "api_enabled": true,
    "device_limit": 20,
    "message": "API access enabled"
  }
}

2. स्क्रिप्ट और उनके पैरामीटर जानें​

GET /api/v1/schema बताता है कि यह बिल्ड कौन-कौन सी स्क्रिप्ट चला सकता है और हर एक script_config में कौन से फ़ील्ड लेता है — नाम, प्रकार, डिफ़ॉल्ट, स्वीकार्य मान, और कौन से अनिवार्य हैं। यह उसी कैटलॉग से बनता है जिससे सर्वर सत्यापन करता है, इसलिए यह टास्क बनाने में स्वीकार होने वाली चीज़ों से अलग नहीं हो सकता।

curl http://localhost:50809/api/v1/schema

दो वैकल्पिक क्वेरी पैरामीटर:

पैरामीटरप्रभाव
platformसूची को tiktok, instagram या threads तक सीमित करता है। जो प्लेटफ़ॉर्म इस बिल्ड में नहीं है उसे 40001 के साथ अस्वीकार किया जाता है। डिफ़ॉल्ट रूप से बिल्ड के सभी प्लेटफ़ॉर्म।
include_unavailabletrue करने पर वे स्क्रिप्ट नाम भी सूचीबद्ध होते हैं जिन्हें API स्वीकार करता है पर जिनका कोई कार्यशील कार्यान्वयन नहीं है। हर एक के साथ unavailable_reason होता है।

प्रतिक्रिया (संक्षिप्त):

{
  "code": 0,
  "message": "success",
  "data": {
    "build": { "platforms": ["tiktok"] },
    "scripts": [
      {
        "name": "follow",
        "internal_name": "follow",
        "summary": "Follow the given users. One task per target.",
        "platforms": ["tiktok", "instagram", "threads"],
        "available": true,
        "fan_out": { "kind": "per_item", "key": "target_users", "alt_key": "target_user" },
        "any_of": [["target_users", "target_user"]],
        "fields": [
          {
            "key": "access_method",
            "type": "string",
            "required": false,
            "default": "direct",
            "choices": ["direct", "search"],
            "description": "How to reach the profile: direct (via URL) or search."
          }
        ]
      }
    ]
  }
}

fan_out बताता है कि एक अनुरोध कितने टास्क बनाएगा: per_device हर डिवाइस पर एक टास्क बनाता है (मल्टी-अकाउंट मोड में हर अकाउंट पर एक), और per_item बताए गए फ़ील्ड की हर प्रविष्टि के लिए, हर डिवाइस पर एक बनाता है।

3. कार्य बनाएं​

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1", "device_serial_2"],
    "script_name": "post",
    "script_config": {
      "content_type": 1,
      "captions": "मेरा नया वीडियो देखें! #trending"
    },
    "enable_multi_account": false
  }'

4. कार्य सूची क्वेरी करें​

curl http://localhost:50809/api/v1/task?status=0&page=1&page_size=20

उपलब्ध स्क्रिप्ट​

script_name पैरामीटर निम्नलिखित मान स्वीकार करता है:

स्क्रिप्ट नामविवरणAPI समर्थन
postवीडियो, इमेज, या Threads के केवल-टेक्स्ट पोस्ट प्रकाशित करें✅ समर्थित
followउपयोगकर्ताओं को फ़ॉलो करें✅ समर्थित
unfollowउपयोगकर्ताओं को अनफ़ॉलो करें✅ समर्थित
account_warmupखातों को वार्मअप करें✅ समर्थित
commentपोस्ट पर नई टिप्पणी करें✅ समर्थित
boost_commentमौजूदा टिप्पणियों को लाइक करें या उनका जवाब दें✅ समर्थित
loginखाते में लॉगिन करें✅ समर्थित
profileप्रोफ़ाइल अपडेट करें✅ समर्थित
match_accountडिवाइस पर खातों का मिलान करें✅ समर्थित
likeपोस्ट को लाइक करें✅ समर्थित
viewपोस्ट को एक निश्चित अवधि तक देखें✅ समर्थित
favoriteपोस्ट को पसंदीदा में सहेजें✅ समर्थित
repostTikTok वीडियो या Threads पोस्ट रीपोस्ट करें✅ समर्थित — TikTok और Threads
messageसीधे संदेश भेजें✅ समर्थित — केवल Threads
follow_backफ़ॉलोवर सूची से खातों को फ़ॉलो करें✅ समर्थित — TikTok, Instagram और Threads
follow_suggestedसुझाए गए खातों को फ़ॉलो करें✅ समर्थित — केवल TikTok
custom_scriptस्वयं पंजीकृत किया गया प्रोग्राम चलाएँ✅ समर्थित ‡
super_marketingसुपर मार्केटिंग अभियान✅ समर्थित †
scrape_usersफ़ॉलोअर, फ़ॉलोइंग या खोज के उपयोगकर्तानाम निर्यात करें✅ समर्थित — TikTok, Instagram और Threads
auto_replyसीधे संदेशों और टिप्पणियों का जवाब दें❌ API के माध्यम से नहीं §
† सुपर मार्केटिंग के लिए समर्पित एंडपॉइंट हैं

सुपर मार्केटिंग अभियान POST /api/v1/task के माध्यम से नहीं बनाया जाता। यह एक पुन: उपयोग योग्य लक्ष्य डेटासेट पर चलता है और इसके अपने एंडपॉइंट हैं — देखें सुपर मार्केटिंग स्क्रिप्ट कॉन्फ़िगरेशन।

केवल Threads पर सीधा मैसेजिंग

स्वतंत्र message टास्क Threads प्रोफ़ाइल → Message फ़्लो चलाता है। TikTok और Instagram के लिए इसके बजाय लक्ष्य डेटासेट वाले super_marketing का उपयोग करें।

प्लेटफ़ॉर्म-विशिष्ट स्क्रिप्ट

repost TikTok और Threads के लिए लागू है; follow_suggested केवल TikTok के लिए ही है। follow_back और scrape_users हर प्लेटफ़ॉर्म की असली डिवाइस पर दिखने वाली फ़ॉलोअर/खोज UI का उपयोग करते हैं और TikTok, Instagram और Threads पर उपलब्ध हैं।

‡ कस्टम स्क्रिप्ट पहले पंजीकृत करनी होंगी

custom_script वह प्रोग्राम चलाता है जिसे आपने डिवाइस → कस्टम स्क्रिप्ट के अंतर्गत पंजीकृत किया है। इसकी आईडी script_config.custom_script_id में दें — देखें कस्टम स्क्रिप्ट।

§ ऑटो-रिप्लाई अपने अलग पेज से चलता है

auto_reply Pro और उससे ऊपर के प्लान में TikTok, Instagram और Threads पर सीधे संदेशों और टिप्पणियों का जवाब देता है। इसके राउंड ऐप के ऑटो-रिप्लाई पेज से शेड्यूल होते हैं, जिसमें जवाब के नियम, कार्य-समय और पॉज़ स्विच रहते हैं; इसलिए इसे POST /api/v1/task के माध्यम से नहीं बनाया जा सकता।

script_config सत्यापन​

टास्क बनाने से पहले script_config को ऊपर दिए स्कीमा से सत्यापित किया जाता है, ताकि गलत पैरामीटर बाद में फ़ोन पर विफल होने वाले टास्क के बजाय, फ़ील्ड का नाम बताने वाले 400 के रूप में लौटे। तीन चीज़ें अस्वीकार होती हैं:

  • कोई अनिवार्य फ़ील्ड जो गायब या खाली हो,
  • ऐसा विकल्प-समूह जिसमें कोई भी सदस्य सेट न हो (उदाहरण के लिए follow को target_users / target_user में से एक चाहिए),
  • किसी फ़ील्ड के प्रलेखित choices से बाहर का मान।

जो कुंजियाँ स्कीमा में नहीं हैं उन्हें अनदेखा किया जाता है, अस्वीकार नहीं — डेस्कटॉप ऐप स्वयं भी उसी ऑब्जेक्ट से अपनी कुंजियाँ भेजता है, और अनजान कुंजियाँ अस्वीकार करने से मौजूदा एकीकरण टूट जाते। उन्हें सर्वर पर लॉग किया जाता है ताकि आप ऐप लॉग में टाइपिंग की गलती पकड़ सकें।

संख्याएँ स्ट्रिंग के रूप में भी भेजी जा सकती हैं (20 के साथ-साथ "20" भी), जैसा स्क्रिप्ट पहले से स्वीकार करती हैं।

कार्य स्थिति​

स्थिति कोडस्थिति टेक्स्टविवरण
0pendingकार्य निष्पादन की प्रतीक्षा में
1runningकार्य निष्पादित हो रहा है
2completedकार्य सफलतापूर्वक निष्पादित
3failedकार्य निष्पादन विफल

आगे​