कनेक्शंस (Connections) API

कनेक्शंस (Connections) API आपको आपके ब्रांड के तहत जुड़े सोशल मीडिया खातों (Instagram, Threads, Bluesky, Facebook Page, TikTok, YouTube) को सूचीबद्ध करने और निरीक्षण करने में सक्षम बनाता है। कंटेंट प्रकाशित करने से पहले लक्षित connection_id प्राप्त करने और अनुमतियों को सत्यापित करने के लिए इस API का उपयोग करें।

📌 एंडपॉइंट्स (Endpoints)

विधि (Method)	पाथ (Path)	विवरण (Description)	आवश्यक स्कोप (Required Scope)
`GET`	`/v1/brand/connections`	वैकल्पिक प्लेटफॉर्म फ़िल्टरिंग के साथ जुड़े SNS खातों को सूचीबद्ध करें	`connections:read` या `*`
`GET`	`/v1/brand/connections/{connection_id}`	कनेक्शन विवरण और लाइव प्रकाशन प्राधिकरण निदान प्राप्त करें	`connections:read` या `*`

📋 कनेक्शंस सूचीबद्ध करें (`GET /v1/brand/connections`)

ब्रांड के तहत सभी जुड़े SNS खातों को प्राप्त करें।

क्वेरी पैरामीटर्स (Query Parameters)

पैरामीटर	प्रकार	आवश्यक	विवरण
`sns_type`	`string`	वैकल्पिक	`instagram`, `threads`, `bluesky`, `facebook_page`, `tiktok`, या `youtube` द्वारा फ़िल्टर करें

अनुरोध उदाहरण (Request Example)

curl -X GET "https://api.ankk.app/v1/brand/connections?sns_type=instagram" \
  -H "Authorization: Bearer spk_live_xxxxxxxx"

प्रतिक्रिया उदाहरण (Response Example) (`200 OK`)

{
  "items": [
    {
      "id": "conn_01jm8x9k2example",
      "sns_type": "instagram",
      "platform": "meta.instagram",
      "display_name": "ACME Official",
      "username": "acme_official",
      "profile_image_url": "https://example.com/profiles/acme.jpg",
      "status": "connected",
      "created_at": "2026-08-01T10:00:00Z"
    }
  ]
}

🔍 कनेक्शन विवरण प्राप्त करें (`GET /v1/brand/connections/{connection_id}`)

लाइव प्रकाशन प्राधिकरण (Publish Authorization) निदान के साथ कनेक्शन विवरण प्राप्त करें।

अनुरोध उदाहरण (Request Example)

curl -X GET "https://api.ankk.app/v1/brand/connections/conn_01jm8x9k2example" \
  -H "Authorization: Bearer spk_live_xxxxxxxx"

प्रतिक्रिया उदाहरण (Response Example) (`200 OK`)

{
  "id": "conn_01jm8x9k2example",
  "sns_type": "instagram",
  "platform": "meta.instagram",
  "display_name": "ACME Official",
  "username": "acme_official",
  "profile_image_url": "https://example.com/profiles/acme.jpg",
  "status": "connected",
  "created_at": "2026-08-01T10:00:00Z",
  "publish_authorization": {
    "status": "scope_authorized",
    "required_scopes": ["instagram_business_basic", "instagram_business_content_publish"],
    "missing_scopes": [],
    "retryable": false
  }
}

प्राधिकरण स्थिति कोड (Authorization Status Codes) (`publish_authorization.status`)

स्थिति	अर्थ और कार्रवाई
`scope_authorized`	पूरी तरह से अधिकृत। प्रकाशित करने के लिए तैयार।
`scope_permission_unverified`	सत्यापन लंबित है। प्रकाशन का प्रयास किया जा सकता है।
`scope_permission_missing`	आवश्यक स्कोप अनुपस्थित हैं। Web UI में पुन: ऑथेंटिकेशन आवश्यक है।
`scope_review_disabled`	प्लेटफॉर्म ऐप समीक्षा स्थिति या डेवलपर मोड सीमाओं द्वारा ब्लॉक किया गया है।
`unsupported`	इस कनेक्शन पर ऑपरेशन समर्थित नहीं है।

🔗 संबंधित दस्तावेज़