सामग्री पर जाएँ
cutty.dev
डेवलपर्स के लिए

API और MCP सर्वर

अपने कोड से छोटे लिंक बनाएँ और प्रबंधित करें — REST API के ज़रिए या अपने AI असिस्टेंट में MCP सर्वर के ज़रिए।

cutty के पास एक सार्वजनिक API और एक MCP सर्वर है। पहला आपको कोड से लिंक बनाने और बदलने देता है; दूसरा सीधे किसी ऐसे AI असिस्टेंट से काम करता है जो MCP प्रोटोकॉल समझता है। दोनों एक ही API कुंजी इस्तेमाल करते हैं।

API कुंजी

हर कॉल को एक हेडर से प्रमाणित करें:

Authorization: Bearer ck_your_key

कुंजी कहाँ से लें: साइन इन करें, अपना dashboard खोलें → API keys → Create key। पूरी कुंजी (जो ck_ से शुरू होती है) केवल एक बार, बनाते समय ही दिखाई जाती है — उसे तुरंत किसी सुरक्षित जगह सहेज लें। सीमा है हर कुंजी पर 120 अनुरोध प्रति मिनट।

Base URL

सभी REST एंडपॉइंट https://cutty.dev/api/v1 के नीचे रहते हैं। अनुरोध और जवाब JSON में होते हैं।

लिंक बनाना

POST /api/v1/links — JSON बॉडी में कम से कम एक url चाहिए। बाकी सब वैकल्पिक है:

  • url — मंज़िल का पता (ज़रूरी)
  • slug — मनचाहा अंत, 3–40 अक्षर; छोड़ देने पर एक यादृच्छिक बन जाता है
  • expiresAt — ISO 8601 फ़ॉर्मैट में समाप्ति की तारीख
  • maxHits — क्लिक की सीमा (1–1,000,000)
  • password — लिंक की रक्षा करने वाला पासवर्ड
  • tags — डैशबोर्ड में व्यवस्थित करने के लिए कॉमा से अलग किए लेबल
  • folder — उस फ़ोल्डर का नाम जिसमें लिंक जाएगा
  • utmSource, utmMedium, utmCampaign — रीडायरेक्ट पर जोड़े जाने वाले UTM पैरामीटर

जवाब में आपको slug, shortUrl और target मिलते हैं।

curl -X POST https://cutty.dev/api/v1/links \
  -H "Authorization: Bearer ck_your_key" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/a/very/long/address","slug":"offer","tags":"campaign,summer"}'

सूची और एकल लिंक

GET /api/v1/links आपके सारे लिंक लौटाता है। GET /api/v1/links/{slug} — किसी एक का ब्यौरा।

curl https://cutty.dev/api/v1/links/offer \
  -H "Authorization: Bearer ck_your_key"

अपडेट करना और मिटाना

PATCH /api/v1/links/{slug} आपके भेजे गए फ़ील्ड अपडेट करता है, DELETE /api/v1/links/{slug} लिंक हटा देता है।

curl -X PATCH https://cutty.dev/api/v1/links/offer \
  -H "Authorization: Bearer ck_your_key" \
  -H "Content-Type: application/json" \
  -d '{"maxHits":500}'

PATCH के ज़रिए आप इनमें से कई चीज़ें सेट कर सकते हैं: targetUrl, expiresAt, maxHits, status, password, tags, folder, और नीचे दिए उन्नत फ़ील्ड। किसी फ़ील्ड को null (या खाली स्ट्रिंग) पर सेट करने से वह गुण मिट जाता है।

टार्गेटिंग, A/B और उन्नत फ़ील्ड

जो चीज़ें आपको लिंक एडिटर में मिलती हैं, वही API से भी उपलब्ध हैं:

  • rules — देश या डिवाइस के हिसाब से रीडायरेक्ट नियमों की एक सरणी, जैसे [{"kind":"country","match":"PL","url":"https://shop.pl"},{"kind":"device","match":"ios","url":"https://apps.apple.com/..."}]
  • abUrls — A/B रोटेशन: एक सरणी [{"url":"https://a.com","weight":1},{"url":"https://b.com","weight":1}]; तब इस्तेमाल होती है जब कोई नियम मेल न खाए
  • startsAt — वह तारीख (ISO 8601) जब लिंक चालू होता है; उससे पहले लिंक 425 लौटाता है
  • webhookUrl — वह पता जिसे हर क्लिक पर एक POST सूचना मिलती है (fire-and-forget)
  • serveOg के साथ ogTitle, ogDescription, ogImageUrl — सोशल क्रॉलरों के लिए एक कस्टम प्रीव्यू कार्ड (इंसानों को फिर भी रीडायरेक्ट मिलता है)
curl -X PATCH https://cutty.dev/api/v1/links/offer \
  -H "Authorization: Bearer ck_your_key" \
  -H "Content-Type: application/json" \
  -d '{"rules":[{"kind":"country","match":"DE","url":"https://example.de"}]}'

थोक संचालन

POST /api/v1/bulk एक ही अनुरोध में कई लिंक बनाता है। एक links सरणी भेजें (हर आइटम सामान्य create जैसा), एक बार में 500 तक। जवाब हर पंक्ति का एक नतीजा लौटाता है।

curl -X POST https://cutty.dev/api/v1/bulk \
  -H "Authorization: Bearer ck_your_key" \
  -H "Content-Type: application/json" \
  -d '{"links":[{"url":"https://a.com"},{"url":"https://b.com","slug":"b"}]}'

लिंक के आँकड़े

GET /api/v1/links/{slug}/stats एक क्लिक सारांश लौटाता है: कुल योग, डिवाइस और ब्राउज़र के हिसाब से ब्यौरा, और पिछले 24 घंटों का वितरण।

curl https://cutty.dev/api/v1/links/offer/stats \
  -H "Authorization: Bearer ck_your_key"

MCP सर्वर

अगर आप किसी AI असिस्टेंट के साथ काम करते हैं, तो आप cutty को MCP (Model Context Protocol) के ज़रिए जोड़ सकते हैं और बातचीत में ही उससे लिंक छोटे करने और व्यवस्थित करने को कह सकते हैं। सर्वर https://mcp.cutty.dev/mcp पर Streamable HTTP के ज़रिए चलता है, और आप वही API कुंजी इस्तेमाल करके प्रमाणित होते हैं — Authorization: Bearer ck_... हेडर।

टूल की पूरी सूची, कनेक्शन स्निपेट और उदाहरण एक अलग पेज पर हैं: cutty MCP सर्वर.

कुछ काम नहीं कर रहा?

[email protected] पर लिखें — मैं उसी दिन जवाब देता हूँ।