वेटलिस्ट

अपने प्रोजेक्ट की लॉन्च-पूर्व वेटलिस्ट प्रबंधित करें। इसके लिए प्रोजेक्ट में वेटलिस्ट सुविधा सक्षम होनी चाहिए।

GET/v1/waitlist/signups

Parameter	Type	Description
`search`	`string`	ईमेल के अंश से फ़िल्टर करें।
`status`	`string`	स्थिति से फ़िल्टर करें: waiting, invited या joined।
`limit`	`integer`	पृष्ठ का आकार। डिफ़ॉल्ट 25।
`offset`	`integer`	छोड़ी जाने वाली वस्तुओं की संख्या। डिफ़ॉल्ट 0।

POST/v1/waitlist/signups

Parameter	Type	Description
`email`required	`string`	शामिल होने वाले व्यक्ति का ईमेल।
`referral_code`	`string`	किसी अन्य प्रविष्टि के शेयर लिंक (`?ref=`) से रेफ़रल कोड।

GET/v1/waitlist/signups/:id

PATCH/v1/waitlist/signups/:id

Parameter	Type	Description
`status`required	`string`	नई स्थिति: waiting, invited या joined। invited से invited_at अंकित होता है; joined से joined_at।

DELETE/v1/waitlist/signups/:id

साइनअप बनाने के लिए सशुल्क-योजना लेखन पहुँच आवश्यक है। API कोई ईमेल नहीं भेजता — पोर्टल स्थिति लिंक (/waitlist/status?token=...) बनाने के लिए लौटाए गए token का और शेयर लिंक के लिए referral_code का उपयोग करें।

साइनअप सूचीबद्ध करना


curl "https://api.supdesk.app/v1/waitlist/signups?status=waiting&limit=10" \
  -H "Authorization: Bearer sd_live_..."


{
  "data": [
    {
      "id": "8f7a...",
      "email": "jamie@example.com",
      "status": "waiting",
      "position": 42,
      "referral_count": 3,
      "referral_code": "a1b2c3",
      "token": "9d8c7b...",
      "source": "api",
      "created_at": "2026-07-01T09:12:00Z",
      "invited_at": null,
      "joined_at": null
    }
  ],
  "pagination": { "limit": 25, "offset": 0, "has_more": false }
}

स्थितियाँ प्रतीक्षारत प्रविष्टियों पर लाइव गणना की जाती हैं; invited और joined प्रविष्टियों की स्थिति null होती है।

एक साइनअप बनाना


curl -X POST https://api.supdesk.app/v1/waitlist/signups \
  -H "Authorization: Bearer sd_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "email": "jamie@example.com" }'


{
  "data": {
    "id": "8f7a...",
    "email": "jamie@example.com",
    "status": "waiting",
    "position": 42,
    "referral_count": 0,
    "referral_code": "a1b2c3",
    "token": "9d8c7b...",
    "source": "api",
    "created_at": "2026-07-01T09:12:00Z",
    "invited_at": null,
    "joined_at": null
  }
}

एक साइनअप प्राप्त करना


curl "https://api.supdesk.app/v1/waitlist/signups/8f7a..." \
  -H "Authorization: Bearer sd_live_..."


{
  "data": {
    "id": "8f7a...",
    "email": "jamie@example.com",
    "status": "waiting",
    "position": 42,
    "referral_count": 3,
    "referral_code": "a1b2c3",
    "token": "9d8c7b...",
    "source": "api",
    "created_at": "2026-07-01T09:12:00Z",
    "invited_at": null,
    "joined_at": null
  }
}

एक साइनअप लौटाता है, या id अज्ञात होने पर 404।

एक साइनअप अपडेट करना


curl -X PATCH https://api.supdesk.app/v1/waitlist/signups/8f7a... \
  -H "Authorization: Bearer sd_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "status": "invited" }'


{
  "data": {
    "id": "8f7a...",
    "email": "jamie@example.com",
    "status": "invited",
    "position": null,
    "referral_count": 3,
    "referral_code": "a1b2c3",
    "token": "9d8c7b...",
    "source": "api",
    "created_at": "2026-07-01T09:12:00Z",
    "invited_at": "2026-07-02T10:00:00Z",
    "joined_at": null
  }
}

केवल status बदला जा सकता है। invited पर जाने से invited_at अंकित होता है; joined पर जाने से joined_at। इसके लिए सशुल्क-योजना लेखन पहुँच आवश्यक है।

एक साइनअप हटाना


curl -X DELETE https://api.supdesk.app/v1/waitlist/signups/8f7a... \
  -H "Authorization: Bearer sd_live_..."

साइनअप को स्थायी रूप से हटाता है और 204 लौटाता है। वही ईमेल फिर से साइन अप कर सकता है।