التوثيق / واجهة المنصة API / Connect and disconnect

Connect and disconnect

Telling QuQi that a site is publishing its articles, and telling it to forget again.

قراءة 4 دقائق All plans

POST /api/v1/platform/connect

POST /api/v1/platform/disconnect

These two endpoints are what the QuQi plugin and app call when someone presses Connect or Disconnect inside them. If you have built your own integration, they are how it announces itself. Only connections made with a platform of wordpress or shopify appear on the Integrations page in the console; any other platform name is recorded but shown nowhere on that page.

انتبه Articles publish to exactly one destination. Sending wordpress or shopify as the platform claims that one slot, so connecting is refused while another publishing destination is set up. Any other platform name skips that check entirely — it connects alongside an existing destination, and it does not claim the slot itself.

Connect

Records the site as your publishing destination and answers with the brand it was matched to. Send it once, when the person installing your integration presses Connect.

site_url string مطلوب

The address of the site being connected. Must be a URL, up to 255 characters.

platform string مطلوب

What the site runs on. Up to 32 characters.

site_name string اختياري

A readable name for the site. Up to 255 characters.

If you send wordpress or shopify and the website already publishes its articles somewhere else, connect fails with 409 and names the destination to disconnect in the console first. Show that message as it is — it tells the person exactly where to go.

Disconnect

Forgets a recorded connection. Name a platform to forget one; leave it out and every recorded connection for that website is forgotten.

platform string اختياري

Which connection to forget. Up to 32 characters. Omit it to forget them all.

معلومة مفيدة Disconnecting only forgets the connection. The API key stays valid and keeps working until you revoke it under Settings → API Keys — see Authentication.

CURL

curl -X POST https://console.quqi.io/api/v1/platform/connect \
  -H "Authorization: Bearer quqi_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"site_url":"https://cornerbakery.example","site_name":"Corner Bakery","platform":"wordpress"}'

RESPONSE

{
  "success": true,
  "message": "…",
  "data": {
    "brand_name": "Corner Bakery",
    "brand_domain": "cornerbakery.example",
    "integration_id": "9f1c2a7e-4b30-4c11-9a6d-2f5c8e1b7d04",
    "connected_at": "2026-08-01T09:14:22+00:00"
  }
}

CURL

curl -X POST https://console.quqi.io/api/v1/platform/disconnect \
  -H "Authorization: Bearer quqi_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"wordpress"}'

RESPONSE

{
  "success": true,
  "message": "Disconnected."
}

هل أجابت هذه الصفحة عن سؤالك؟ نعم ليس تمامًا

One article

Errors