Share Notes डेवलपर्स

त्वरित शुरुआत

सेकंड में Share Notes API शुरू करें।

# Search sites
curl https://Share.Mini-Apps.net/api/sites?search=AI+tools

# Get trending
curl https://Share.Mini-Apps.net/api/sites?sort=hot

# Submit a URL
curl -X POST https://Share.Mini-Apps.net/api/sites \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

# Get chat messages
curl https://Share.Mini-Apps.net/api/messages?limit=10

# Send a message
curl -X POST https://Share.Mini-Apps.net/api/messages \
  -H "Content-Type: application/json" \
  -d '{"content": "Hello from the API!"}'

API संदर्भ

सभी एंडपॉइंट JSON का उपयोग करते हैं। बेस URL: https://Share.Mini-Apps.net

{
  "sites": [{ "id": "abc123", "url": "https://example.com", "title": "Example", ... }],
  "total": 42,
  "page": 1,
  "hasMore": true
}

{
  "url": "https://example.com",        // required
  "turnstileToken": "cf-..."    // required when CAPTCHA enabled
}

{ "site": { ... }, "isNew": true }

{ "site": { ... }, "isNew": false }

400 — Invalid URL or request format
403 — Missing or invalid Turnstile token
429 — Rate limited (5/min per IP)

{ "tags": ["工具", "技术", "设计", "新闻", "社区", ...] }

{ "site": { ... }, "credits": 0 }

404 — Site not found
429 — Daily limit reached (1/day free, 3/day logged-in)

{ "site": { ... }, "verified": true }

400 — Verification meta tag not found / already claimed
404 — Site not found

{ "recorded": true }

{
  "messages": [{
    "id": "abc", "type": "chat",
    "content": "Hello!", "sender_name": "user123",
    "created_at": "2026-03-27T12:00:00Z"
  }]
}

{ "content": "Hello from the API!" }

{ "message": { "id": "...", "type": "chat", ... } }

400 — Empty or exceeds 200 chars
429 — Rate limited (10/min per IP)

{
  "text": "Hello world",       // max 2000 chars
  "targetLang": "zh-CN"
}

{ "translated": "你好世界" }

400 — Missing params or text too long
429 — Rate limited (20/min per IP)
500 — AI translation failed

{
  "imageUrl": "https://www.bing.com/...",
  "videoUrl": "https://...",  // or null
  "copyright": "Photo credit...",
  "title": "Image title"
}

{ "email": "user@example.com" }

{ "sent": true }

{ "email": "user@example.com", "code": "123456" }

{ "user": { "id": "...", "email": "...", "username": "..." } }

{ "bookmarks": [{ "site_id": "...", "created_at": "..." }] }

डेटा मॉडल

मूल डेटा संरचनाएँ।

Site

ChatMessage

WebSocket API

रियल-टाइम अपडेट के लिए WebSocket से कनेक्ट करें।

कनेक्शन

// Browser
const ws = new WebSocket("wss://Share.Mini-Apps.net/api/ws");

ws.onmessage = (event) => {
  const data = JSON.parse(event.data);
  console.log(data.event, data.payload);
};

इवेंट प्रकार

उदाहरण

// new_message event payload
{
  "event": "new_message",
  "payload": {
    "id": "abc123",
    "type": "entrance",
    "content": "entered",
    "content_key": "chat.entered",
    "sender_name": "United States Dallas",
    "sender_location": "US|Dallas",
    "created_at": "2026-03-27T12:00:00Z"
  }
}

// site_update event payload
{
  "event": "site_update",
  "payload": {
    "id": "xyz789",
    "title": "Example Site",
    "description": "A great website",
    "tags": ["工具", "技术"]
  }
}

// like event payload
{
  "event": "like",
  "payload": {
    "messageId": "msg123",
    "fromUser": "United States Dallas",
    "toUser": "Japan Tokyo"
  }
}

प्रमाणीकरण

अधिकांश एंडपॉइंट सार्वजनिक हैं।

लॉगिन फ़्लो

1. ईमेल पर कोड भेजें

curl -X POST https://Share.Mini-Apps.net/api/auth/send-code \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com"}'

2. कोड सत्यापित करें

curl -X POST https://Share.Mini-Apps.net/api/auth/verify \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com", "code": "123456"}'

संरक्षित एंडपॉइंट

AI सुविधाएँ

Share Notes Cloudflare Workers AI का उपयोग करता है।

स्वचालित टैगिंग

URL सबमिट करने पर AI सामग्री का विश्लेषण करता है।

उपलब्ध टैग

अनुवाद

12 भाषाओं का समर्थन।

समर्थित भाषाएँ

सोशल प्रोफ़ाइल पहचान

सोशल प्लेटफ़ॉर्म URL स्वचालित रूप से पहचाने जाते हैं।

समर्थित प्लेटफ़ॉर्म

URL पैटर्न मिलान पर आधारित।

प्रोफ़ाइल फ़ील्ड

साइट स्वामित्व दावा

साइट मालिक स्वामित्व सत्यापित कर सकते हैं।

सत्यापन चरण

1. Share.Mini-Apps.net पर अपनी साइट खोजें

2. HTML में meta टैग जोड़ें

<meta name="sharenotes-verify" content="YOUR_SITE_ID">

3. क्लेम API कॉल करें

curl -X POST https://Share.Mini-Apps.net/api/sites/YOUR_SITE_ID/claim

लाभ

• सत्यापित बैज
• क्लिक विश्लेषण
• खोज में प्राथमिकता
• विवरण और टैग प्रबंधित करें

दर सीमा

सीमाएँ प्रति IP लागू होती हैं।

CLI टूल

Share Notes का आधिकारिक CLI टूल।

इंस्टॉलेशन

# Install globally
npm install -g @sharenotes/cli

# Or use directly with npx
npx sharenotes help

कमांड

वैश्विक विकल्प

उदाहरण

# Search for AI tools
sharenotes search "AI tools"

# Get trending sites as JSON
sharenotes trending --json

# Filter by tag
sharenotes tag 技术

# Submit a site
sharenotes submit https://example.com

# Boost a site
sharenotes boost abc123

# Translate text
sharenotes translate "Hello world" --to ja

# Send chat message
sharenotes send "Hello from CLI!"

# Pipe JSON output to jq
sharenotes search "design" --json | jq '.sites[].title'

कोड उदाहरण

सामान्य एकीकरण पैटर्न।

साइट खोजें

curl -s "https://Share.Mini-Apps.net/api/sites?search=AI+tools&sort=hot" | jq .

const res = await fetch('https://Share.Mini-Apps.net/api/sites?search=AI+tools');
const { sites, total } = await res.json();
console.log(`Found ${total} sites`);
sites.forEach(s => console.log(s.title, s.url));

import requests

r = requests.get("https://Share.Mini-Apps.net/api/sites", params={"search": "AI tools"})
data = r.json()
for site in data["sites"]:
    print(site["title"], site["url"])

URL सबमिट करें

curl -X POST https://Share.Mini-Apps.net/api/sites \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

const res = await fetch('https://Share.Mini-Apps.net/api/sites', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ url: 'https://example.com' })
});
const { site, isNew } = await res.json();
console.log(isNew ? 'New!' : 'Already exists', site.title);

import requests

r = requests.post("https://Share.Mini-Apps.net/api/sites", json={"url": "https://example.com"})
data = r.json()
print("New!" if data["isNew"] else "Exists", data["site"]["title"])

WebSocket रियल-टाइम

// Browser WebSocket client
const ws = new WebSocket("wss://Share.Mini-Apps.net/api/ws");

ws.onopen = () => console.log("Connected!");

ws.onmessage = (event) => {
  const { event: type, payload } = JSON.parse(event.data);
  switch (type) {
    case "new_message":
      console.log(`[${payload.sender_name}] ${payload.content}`);
      break;
    case "site_update":
      console.log(`Site updated: ${payload.title}`);
      break;
    case "like":
      console.log(`${payload.fromUser} liked a message`);
      break;
  }
};

ws.onclose = () => console.log("Disconnected");

परिवर्तन लॉग

API संस्करण इतिहास।

खोज एंडपॉइंट

AI एजेंट के लिए मशीन-पठनीय एंडपॉइंट।