API Discord Server
Stato di salute dell'API
- Operatività nelle ultime 24 ore
- Normale
- Buono / normale
- Disponibile
- Limitato
- Quasi del tutto inattivo
Ultime 24 ore
Ultimi 30 giorni
Risolvi un codice o un link di invito Discord nei dati del server: nome, descrizione, numero di membri totali e online, Boost e livello di verifica, oltre a canale, autore e scadenza dell'invito. Leggere un invito non fa entrare nel server, e un expires_at null indica che l'invito non scade mai.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su discord e action impostato su server. Prezzo $1.39 per 1.000 richieste ($0.001389 per chiamata). Le chiamate non riuscite e i risultati vuoti non vengono addebitati. Sincrona. Per i job più lenti, aggiungi "mode": "async" al corpo della richiesta, recupera il job_id ed esegui il polling.
Prompt per l'AI
#Aiutami a scrivere uno script di raccolta dei dati con l'endpoint Discord Server di EveryInfra (discord/server).
Come funziona l'endpoint:
- Richiesta: POST https://api.everyinfra.com/api/v1/social con l'header Authorization: Bearer <chiave API>. Leggi la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY e non scriverla mai direttamente nel codice.
- Nel corpo della richiesta imposta platform su discord e action su server, e inserisci i parametri in params.
- Parametri obbligatori:
- invite: Identifica il server tramite un codice d'invito o un URL completo (discord.gg/<code> o discord.com/invite/<code>). L'azione server legge i metadati pubblici associati all'invito senza entrare nel server.
- Parametri facoltativi:
- code: Accetta il segmento del codice di un link d'invito come alias di compatibilità per il parametro invite. La richiesta deve comunque includere il parametro obbligatorio invite.
- url: Alias di compatibilità per il parametro invite che accetta un link d'invito Discord completo. La richiesta deve comunque includere il parametro obbligatorio invite.
- Restituisce un oggetto. Campi principali: id, name, url, text, member_count, online_count, boost_count, invite_code, vanity_url_code, icon_url, banner_url, verification_level; 18 campi in totale, elenco completo su https://api.everyinfra.com/api/v1/social/catalog?platform=discord.
- Esempio di corpo della richiesta:
{
"platform": "discord",
"action": "server",
"params": {
"invite": "discord.gg/limewire"
}
}
- Prezzo: $1.39 per 1.000 richieste; le richieste non riuscite e i risultati vuoti non vengono addebitati.
- Per decine o centinaia di target, aggiungi "mode": "async" al corpo: ricevi subito un job_id ed esegui il polling su GET https://api.everyinfra.com/api/v1/jobs/{job_id} per ottenere il risultato.
- In caso di 422, correggi la richiesta usando i nomi dei parametri e i valori consentiti suggeriti nell'errore; in caso di 429 o 503, attendi il tempo indicato da Retry-After e riprova.
Prima di scrivere il codice, chiedimi quali target mi servono, quanti, quali campi e quale formato di output voglio; poi conferma con me il piano e il costo indicativo.Parametri della richiesta
#| Nome | Posizione | Tipo | Obbligatorio | Predefinito | Descrizione |
|---|---|---|---|---|---|
Authorization | header | string | Sì | - | Bearer seguito dalla tua chiave API. Creala nella console; non inserirla mai in un URL o in un repository di codice. |
platform | body | string | Sì | discord | Identificativo della piattaforma, valore fisso. |
action | body | string | Sì | server | Identificativo della funzionalità, valore fisso. |
invite | body.params | string | Sì | - | Identifica il server tramite un codice d'invito o un URL completo (discord.gg/<code> o discord.com/invite/<code>). L'azione server legge i metadati pubblici associati all'invito senza entrare nel server; un invito scaduto o non valido non dimostra che il server non esista. |
code | body.params | string | No | - | Accetta il segmento del codice di un link d'invito come alias di compatibilità per il parametro invite. La richiesta deve comunque includere il parametro obbligatorio invite; questo campo non accetta codici di verifica, token di bot o ID server. |
url | body.params | string | No | - | Alias di compatibilità per il parametro invite che accetta un link d'invito Discord completo. La richiesta deve comunque includere il parametro obbligatorio invite; i link a messaggi dei canali non sono accettati come inviti validi. |
Esempi di codice
#curl -X POST 'https://api.everyinfra.com/api/v1/social' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"platform": "discord",
"action": "server",
"params": {
"invite": "discord.gg/limewire"
}
}'Definizione OpenAPI (JSON)Gli esempi leggono la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY; il codice copiato non contiene mai la tua chiave.
Esempio di risposta
#{ "id": "req_…", "platform": "discord", "action": "server", "results": { "id": "•••", "name": "LimeWire", "url": "https://discord.gg/limewire", "text": "The new LimeWire", "member_count": 1957101, "online_count": 28267, "boost_count": 8, "invite_code": "limewire", "vanity_url_code": "limewire", "icon_url": "https://cdn.discordapp.com/icons/1046979304547954728/bbe5d6097255431300cfc18dd629b876.png", "banner_url": "https://cdn.discordapp.com/banners/1046979304547954728/d16ea54ee56246388b498ee9256de5ed.png", "verification_level": "LOW", "nsfw_level": "DEFAULT", "channel_name": "📢︱updates", "channel_type": "ANNOUNCEMENT", "platform": "discord" }, "billing": { "charged": …, "charged_usd": …, "balance_after_usd": …, … }, "quota": { … }}
Campi della risposta
#I dati di business si trovano in results. La tabella elenca i campi che un record può contenere; i valori che la piattaforma non mostra non vengono mai inventati.
| Campo | Significato |
|---|---|
id | ID univoco del record sulla piattaforma. È univoco solo all'interno di una piattaforma; gli ID possono ripetersi tra piattaforme diverse. |
name | Nome dell'oggetto stesso, per le funzionalità relative ad account, prodotti e attività. |
url | Link al record sulla piattaforma. |
text | Testo del contenuto senza HTML, restituito per intero e mai troncato (su alcune piattaforme i risultati degli elenchi contengono solo un estratto; lo indicano le note sui campi della piattaforma). |
member_count | Mantiene il significato attribuito dalla piattaforma |
online_count | Mantiene il significato attribuito dalla piattaforma |
boost_count | Mantiene il significato attribuito dalla piattaforma |
invite_code | Mantiene il significato attribuito dalla piattaforma |
vanity_url_code | Mantiene il significato attribuito dalla piattaforma |
icon_url | Mantiene il significato attribuito dalla piattaforma |
banner_url | Mantiene il significato attribuito dalla piattaforma |
verification_level | Mantiene il significato attribuito dalla piattaforma |
nsfw_level | Mantiene il significato attribuito dalla piattaforma |
channel_name | Mantiene il significato attribuito dalla piattaforma |
channel_type | Mantiene il significato attribuito dalla piattaforma |
inviter_username | Mantiene il significato attribuito dalla piattaforma |
inviter_name | Mantiene il significato attribuito dalla piattaforma |
expires_at | Mantiene il significato attribuito dalla piattaforma |
platform | Identificativo della piattaforma di origine, uguale a platform nella richiesta (ad esempio xiaohongshu, tiktok). |
Errori e addebiti
#- 401
- Chiave mancante o non valida.
- 402
- Saldo insufficiente. Effettua prima una ricarica.
- 422
- Nome o valore del parametro non valido. Correggilo seguendo i suggerimenti dell'errore. Nessun addebito.
- 429
- Raggiunto il limite di richieste al minuto. Attendi il tempo indicato da Retry-After, poi riprova.
- 503
- Impossibile completare. L'importo trattenuto torna sul tuo saldo. Se l'esito è incerto, verificalo prima di riprovare.
- Risposta 200 vuota
- Nessun dato. Nessun addebito.
Riferimenti ufficiali
#Usati solo per verificare oggetti e terminologia. Non implicano alcuna autorizzazione o approvazione di EveryInfra da parte della piattaforma.
- Inviti di Discord: codici di invito, server e canali sono oggetti distinti ↗
Gli oggetti Invite ufficiali di Discord separano `code`, `guild`, `channel`, `inviter` ed `expires_at`, e trattano come approssimativi i numeri di membri restituiti dagli inviti. Questo riferimento chiarisce le relazioni tra gli oggetti e i limiti dei conteggi, senza implicare il supporto per creare o eliminare inviti o per gestire gli utenti di destinazione.
Verificato il 2026-09-04