İçeriğe geç

Sunucu Bileşeni

GET/v1/discord/server1 kredi

Bir Discord sunucusunun herkese açık bileşenini sunucu kimliğiyle döndürür: ad, davet bağlantısı, ses kanalları, en fazla 100 çevrim içi üyeden oluşan bir örnek ve çevrim içi üye sayısı.

01Sorgu parametreleri

AdTürAçıklama
guild_idzorunlustringSunucunun sayısal kimliği, örneğin `267624335836053506` (bir davetin `guild.id` değeri).

02İstek

curl "https://api.scrapesocial.ai/v1/discord/server?guild_id=267624335836053506" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Yanıtlar

API'nin gerçek yanıtları. Listeler 2 öğeye kısaltılmıştır.

GET /v1/discord/server?guild_id=267624335836053506

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "id": "267624335836053506",
  "name": "Python",
  "instant_invite": "https://discord.com/invite/4DB7Jxz5",
  "channels": [
    {
      "id": "756327105389920306",
      "name": "AFK",
      "position": 22
    },
    {
      "id": "751592231726481530",
      "name": "Code/Help",
      "position": 20
    }
  ],
  "members": [
    {
      "id": "0",
      "username": "! Bounty",
      "discriminator": "0000",
      "avatar": null,
      "status": "dnd",
      "avatar_url": "https://cdn.discordapp.com/widget-avatars/72VUXxMat45B96OljKUXGDhSta6mxIiPKs0DhkKXgLs/C4YdkwnrLQvXS_-RQNx4ASsGvo3Th-ZELSy4AfQ8seZqimjx1BqX7VHtS-eM3lMhhFROcg-TAb2AtBFp_ZR8aeP5ZvQg4pFq7wGV_OBTI1L2ustGwf259bPCQfzNgaTAEoaDBE3WkczgWwANig"
    },
    {
      "id": "1",
      "username": "alen",
      "discriminator": "0000",
      "avatar": null,
      "status": "idle",
      "avatar_url": "https://cdn.discordapp.com/widget-avatars/xulnGDmcgvjV0OhVW9Tn5MsA7wtOT5TtgJRxm8C25gc/iQ67GCCq9VDApp-oIkC9QIFB7BZDnAFfwljpH2T0eHQPJRua6nTmGrpFMq72ly7-95PROzoScxWEEuAjuUl9iLTqCz0vAZ4blDpKpPZbXG8eHVmsy2A9axSwdDpXtWRYbVDYs0I3hV04gg"
    }
  ],
  "presence_count": 48354
}

Tüm uç noktalarda ortak

Her rota bunları döndürebilir: eksik ya da hatalı anahtar, biten kredi, yanıt vermeyen platform ya da bizim tarafımızdaki bir hata. Hiçbiri kredi harcamaz.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notlar

Yalnızca bileşenini açmış sunucularda bileşen vardır; diğerleri için yanıt ücretsiz bir 403 `widget_disabled` hatasıdır (bunun yerine Davet uç noktasını kullanın). Bulunamayan bir sunucu kimliği ücretsiz bir 404 döndürür; sayı olmayan bir değer ücretsiz bir 400 hatası verir.

05Hatalar ve krediler

Her hatada success: false ve gerçek bir HTTP durum kodu döner; kredi düşmez.

  • 400missing_parameter

    Zorunlu bir parametre eksik veya geçersiz.

  • 403private_account

    Hesap gizli ya da yaş kısıtlamalı.

  • 404not_found

    Böyle bir hesap yok.

  • 503upstream_error

    Platform şu an cevap vermiyor; tekrar deneyin.