NG Entwickler

Schnellstart

Starten Sie in Sekunden mit der NG API. Alle öffentlichen Endpunkte erfordern keine Authentifizierung.

# Search sites
curl https://ng.net/api/sites?search=AI+tools

# Get trending
curl https://ng.net/api/sites?sort=hot

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

# Get chat messages
curl https://ng.net/api/messages?limit=10

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

API-Referenz

Alle Endpunkte verwenden JSON. Basis-URL: https://ng.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": "..." }] }

Datenmodelle

Kerndatenstrukturen der API.

Site

ChatMessage

WebSocket-API

Verbinden Sie sich mit dem WebSocket für Echtzeit-Updates.

Verbindung

// Browser
const ws = new WebSocket("wss://ng.net/api/ws");

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

Ereignistypen

Beispiel

// 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"
  }
}

Authentifizierung

Die meisten Endpunkte sind öffentlich. Einige Funktionen erfordern E-Mail-Login.

Login-Ablauf

1. Bestätigungscode per E-Mail senden

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

2. Code verifizieren und Sitzung erhalten

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

Geschützte Endpunkte

KI-Funktionen

NG nutzt Cloudflare Workers AI für intelligente Funktionen.

Auto-Tagging

Bei URL-Einreichung analysiert die KI den Inhalt und vergibt automatisch Kategorie-Tags.

Verfügbare Tags

Übersetzung

Die Übersetzungs-API unterstützt 12 Sprachen mit automatischer Quellspracherkennung.

Unterstützte Sprachen

Social-Profil-Erkennung

URLs von sozialen Plattformen werden automatisch erkannt und als Profilkarten angezeigt.

Unterstützte Plattformen

Erkennung basiert auf URL-Musterabgleich.

Profilspezifische Felder

Site-Eigentum beanspruchen

Website-Besitzer können das Eigentum verifizieren.

Verifizierungsschritte

1. Finden Sie Ihre Site auf ng.net

2. Fügen Sie ein Meta-Tag zum HTML hinzu

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

3. Rufen Sie den Claim-Endpunkt auf

curl -X POST https://ng.net/api/sites/YOUR_SITE_ID/claim

Vorteile

• Verifiziertes Abzeichen
• Klickanalyse-Zugang
• Priorität in Suchergebnissen
• Beschreibung und Tags verwalten

Rate-Limits

Rate-Limits gelten pro IP-Adresse.

CLI-Tool

Offizielles CLI-Tool für die NG Share Platform.

Installation

# Install globally
npm install -g @ngnet/cli

# Or use directly with npx
npx ngnet help

Befehle

Globale Optionen

Beispiele

# Search for AI tools
ngnet search "AI tools"

# Get trending sites as JSON
ngnet trending --json

# Filter by tag
ngnet tag 技术

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

# Boost a site
ngnet boost abc123

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

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

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

Codebeispiele

Gängige Integrationsmuster.

Sites suchen

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

const res = await fetch('https://ng.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://ng.net/api/sites", params={"search": "AI tools"})
data = r.json()
for site in data["sites"]:
    print(site["title"], site["url"])

URL einreichen

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

const res = await fetch('https://ng.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://ng.net/api/sites", json={"url": "https://example.com"})
data = r.json()
print("New!" if data["isNew"] else "Exists", data["site"]["title"])

WebSocket Echtzeit

// Browser WebSocket client
const ws = new WebSocket("wss://ng.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");

Änderungsprotokoll

API-Versionshistorie.

Discovery-Endpunkte

Maschinenlesbare Endpunkte für AI-Agenten.