# NG Share Platform (ng.net)

> Next-gen website sharing platform. Anyone can anonymously submit URLs — AI auto-categorizes them, and users interact via real-time chat.
>
> 新世代网站分享平台。任何人可匿名提交网址，AI 自动分类，实时聊天互动。

## API Quickstart

Base URL: https://ng.net

### Search Sites
GET /api/sites?search={query}&tag={tag}&sort=hot|recent&page=1
Returns: { sites: Site[], total, page, hasMore }

### Submit a URL
POST /api/sites
Body: { "url": "https://example.com", "turnstileToken": "..." }
Returns: { site: Site, isNew: boolean }
Note: Requires Cloudflare Turnstile CAPTCHA token.

### Get All Tags
GET /api/sites/tags
Returns: { tags: string[] }

### Get Chat Messages
GET /api/messages?limit=50
Returns: { messages: ChatMessage[] }

### Send Chat Message
POST /api/messages
Body: { "content": "Hello world" }
Returns: { message: ChatMessage }
Rate limit: 10/min per IP. Max 200 chars.

### Translate Text
POST /api/translate
Body: { "text": "...", "targetLang": "en" }
Supported: zh-CN, zh-HK, zh-TW, en, es, ar, hi, pt, ja, ko, fr, de

### Boost a Site
POST /api/sites/{id}/boost
Rate limit: 1/day per IP (3 for logged-in users)

### Daily Background
GET /api/bing-bg
Returns: { imageUrl, videoUrl, copyright, title }

## Documentation

- OpenAPI 3.1 spec: https://ng.net/openapi.json
- Full LLM context: https://ng.net/llms-full.txt
- Developer page: https://ng.net/developers
- AI Plugin manifest: https://ng.net/.well-known/ai-plugin.json

## Contact

KANG — k@ng.net