Docs / API de la plateforme / Connect and disconnect

Connect and disconnect

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

4 min de lecture 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.

ATTENTION 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 OBLIGATOIRE

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

platform string OBLIGATOIRE

What the site runs on. Up to 32 characters.

site_name string FACULTATIF

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 FACULTATIF

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

BON À SAVOIR 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."
}

Cette page a-t-elle répondu à votre question ? Oui Pas vraiment

One article

Errors