İçeriğe geç

Davet

GET/v1/discord/invite1 kredi

Bir Discord davet bağlantısını çözer ve arkasındaki herkese açık sunucuyu döndürür: sunucu kimliği, adı, açıklaması, simge, kapak ve açılış görselleri, özellikleri, davetin açtığı kanal, daveti oluşturan kişi, bitiş zamanı ile yaklaşık üye ve çevrim içi sayıları.

01Sorgu parametreleri

AdTürAçıklama
urlzorunlustringDavet: `discord.gg/<kod>`, `discord.com/invite/<kod>`, `discordapp.com/invite/<kod>` ya da yalnızca kod. `python` gibi özel davet kodları da çalışır.

02İstek

curl "https://api.scrapesocial.ai/v1/discord/invite?url=https%3A%2F%2Fdiscord.gg%2Fpython" \
  -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/invite?url=https://discord.gg/python

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "is_valid": true,
  "type": 0,
  "code": "python",
  "expires_at": null,
  "id": 0,
  "flags": 2,
  "guild": {
    "id": "267624335836053506",
    "name": "Python",
    "splash": "b7099fe221153a7faff76048dc2e63ef",
    "banner": "ed3be5b67371fe219d7006152087afdb",
    "description": "We're a large community focused around the Python programming language. We believe that anyone can learn to code.",
    "icon": "a_421bfdb0fba2e5bbf0408c0f2bc15f53",
    "features": [
      "VANITY_URL",
      "AUTOMOD_TRIGGER_ML_SPAM_FILTER"
    ],
    "verification_level": 2,
    "vanity_url_code": "python",
    "nsfw_level": 0,
    "nsfw": false,
    "premium_subscription_count": 28,
    "premium_tier": 3,
    "icon_url": "https://cdn.discordapp.com/icons/267624335836053506/a_421bfdb0fba2e5bbf0408c0f2bc15f53.gif",
    "banner_url": "https://cdn.discordapp.com/banners/267624335836053506/ed3be5b67371fe219d7006152087afdb.png",
    "splash_url": "https://cdn.discordapp.com/splashes/267624335836053506/b7099fe221153a7faff76048dc2e63ef.png"
  },
  "guild_id": "267624335836053506",
  "channel": {
    "id": "267631170882240512",
    "type": 0,
    "name": "welcome"
  },
  "profile": {
    "id": "267624335836053506",
    "name": "Python",
    "icon_hash": "a_421bfdb0fba2e5bbf0408c0f2bc15f53",
    "member_count": 432481,
    "online_count": 48248,
    "description": "We're a large community focused around the Python programming language. We believe that anyone can learn to code.",
    "banner_hash": null,
    "game_application_ids": [],
    "game_activity": {},
    "tag": "snek",
    "badge": 0,
    "badge_color_primary": "#008cff",
    "badge_color_secondary": "#fdf300",
    "badge_hash": "fd3549e1a1a692afda2a7b4cf6b6cad6",
    "traits": [],
    "features": [
      "MEMBER_VERIFICATION_GATE_ENABLED",
      "DISCOVERABLE"
    ],
    "visibility": 1,
    "custom_banner_hash": "99f4a269f925d0c495dc2711e78e00df",
    "premium_subscription_count": 28,
    "premium_tier": 3
  },
  "approximate_member_count": 432481,
  "approximate_presence_count": 48248
}

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

Geçerli bir davet, Discord'un davet nesnesiyle birlikte `is_valid: true` döndürür; sunucu `guild` içindedir ve görsel özetlerinden oluşturulan `icon_url`, `banner_url` ve `splash_url` alanlarıyla gelir; sayılar `approximate_member_count` ve `approximate_presence_count` alanlarındadır. Bulunamayan ya da süresi dolmuş bir davet ücretsiz bir 404 döndürür; Discord daveti 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.