NG Développeurs

Démarrage rapide

Commencez avec l'API NG en quelques secondes. Tous les endpoints publics ne nécessitent aucune authentification.

# 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!"}'

Référence API

Tous les endpoints utilisent JSON. URL de base : 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": "..." }] }

Modèles de données

Structures de données principales.

Site

ChatMessage

API WebSocket

Connectez-vous au WebSocket pour des mises à jour en temps réel.

Connexion

// 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);
};

Types d'événements

Exemple

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

Authentification

La plupart des endpoints sont publics. Certaines fonctions nécessitent une connexion par email.

Flux de connexion

1. Envoyer le code de vérification par email

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

2. Vérifier le code et obtenir la session

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

Endpoints protégés

Fonctions IA

NG utilise Cloudflare Workers AI pour des fonctions intelligentes.

Étiquetage automatique

Lors de la soumission d'une URL, l'IA analyse le contenu et attribue automatiquement des étiquettes.

Étiquettes disponibles

Traduction

L'API de traduction prend en charge 12 langues avec détection automatique de la langue source.

Langues prises en charge

Détection de profils sociaux

Les URLs de plateformes sociales sont automatiquement détectées et affichées comme cartes de profil.

Plateformes prises en charge

Détection basée sur la correspondance de motifs d'URL.

Champs spécifiques au profil

Revendiquer un site

Les propriétaires de sites peuvent vérifier leur propriété pour débloquer des fonctions supplémentaires.

Étapes de vérification

1. Trouvez votre site sur ng.net

2. Ajoutez une balise meta au HTML

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

3. Appelez l'endpoint de réclamation

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

Avantages

• Badge vérifié
• Accès aux analyses de clics
• Priorité dans les résultats
• Gérer la description et les étiquettes

Limites de débit

Les limites s'appliquent par adresse IP.

Outil CLI

Outil CLI officiel pour la Plateforme NG Share.

Installation

# Install globally
npm install -g @ngnet/cli

# Or use directly with npx
npx ngnet help

Commandes

Options globales

Exemples

# 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'

Exemples de code

Modèles d'intégration courants.

Rechercher des sites

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"])

Soumettre une URL

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 temps réel

// 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");

Journal des modifications

Historique des versions de l'API.

Points de découverte

Points d'entrée lisibles par machine pour les agents AI.