N'oluyo · Geliştirici Dokümanları · Son güncelleme: · https://noluyo.net/gelistirici

Uygulamalar

Geliştirici portalının kullandığı rotalar; bot token'ıyla değil, bir kişinin oturumuyla çağrılır.

Uygulamalar

Geliştirici portalının kullandığı rotalar; bot token'ıyla değil, bir kişinin oturumuyla çağrılır.

Uygulamalarını listele (listApplications)

GET https://noluyo.net/api/v1/applications (GET /applications)

Geliştirici portalı bu rotayı, bot token'ıyla değil, bir kişinin oturumuyla (Authorization: Bearer) kullanır. Kendin yalnızca otomasyon için çağır. Hesabın sahip olduğu uygulamaları döndürür. Token'lar asla yer almaz.

  • Kimlik: Yalnızca kullanıcı oturumu (bot token'ı reddedilir)

Örnek çağrılar

curl -X GET "https://noluyo.net/api/v1/applications" \
  -H "Authorization: Bearer $SESSION_TOKEN"
// JavaScript (noluyo-bot)
await bot.rest.listApplications({ accessToken: process.env.SESSION_TOKEN });
# Python (noluyo_bot)
await bot.rest.list_applications(access_token=os.environ["SESSION_TOKEN"])

Yanıt (200)

[
  {
    "id": "111540000000000000",
    "owner_id": "111400000000000500",
    "name": "Örnek Bot",
    "description": "Sunucuya hoş geldin diyen bot",
    "public": false,
    "verified": false,
    "bot": {
      "id": "111540000000000001",
      "username": "ornek_bot",
      "display_name": "Örnek Bot",
      "avatar": null,
      "cosmetics": null,
      "bot": true
    },
    "created_at": "2026-11-04T19:00:08.312Z",
    "privileged_intents": 0,
    "approved_intents": 0,
    "guild_count": 0,
    "interactions_endpoint_url": null,
    "public_key": "3b6a27bcceb6a42d62a3a8d02a6f0d73653215771de243a63ac048a18b59da29",
    "redirect_uris": [],
    "oauth_public": false,
    "privacy_url": null,
    "terms_url": null,
    "has_oauth_secret": false,
    "listed": false,
    "listing_category": null,
    "listing_text": null,
    "support_url": null,
    "website_url": null,
    "install_permissions": "0"
  }
]

Hata kodları

  • HTTP 401: unauthorized
  • HTTP 403: bot_forbidden, temporarily_banned
  • HTTP 429: rate_limited
  • HTTP 503: maintenance

Uygulama oluştur (createApplication)

POST https://noluyo.net/api/v1/applications (POST /applications)

Geliştirici portalı bu rotayı, bot token'ıyla değil, bir kişinin oturumuyla (Authorization: Bearer) kullanır. Kendin yalnızca otomasyon için çağır. Bir uygulama ve botunu oluşturur, bot token'ıyla yanıt verir. Token'ın gösterildiği yalnızca iki yerden biri budur; hemen sakla. Şimdilik yalnızca kapalı döneme davet edilen hesaplar uygulama oluşturabilir ve e-postaları doğrulanmış olmalıdır. username (a-z, 0-9, _ ve . içinden 4 ile 32 karakter; art arda iki nokta olamaz) küçük harfe çevrilir ve sonradan değiştirilemez. name en çok 32, description en çok 400 karakterdir. Bir hesap en çok 25 uygulamaya sahip olabilir. Platform açıldıktan sonra hesabın önce geliştirici sözleşmesini kabul etmesi gerekir (POST /applications/developer-terms), aksi halde developer_terms_required.

  • Kimlik: Yalnızca kullanıcı oturumu (bot token'ı reddedilir)

Gövde alanları

AlanTürZorunluAçıklama
namestringevet(1–32)
usernamestringevet(4–32)
descriptionstring | null-(<= 400)

Örnek çağrılar

curl -X POST "https://noluyo.net/api/v1/applications" \
  -H "Authorization: Bearer $SESSION_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"name":"Örnek Bot","username":"ornek_bot","description":"Sunucuya hoş geldin diyen bot"}'
// JavaScript (noluyo-bot)
await bot.rest.createApplication({ name: "Örnek Bot", username: "ornek_bot", description: "Sunucuya hoş geldin diyen bot" }, { accessToken: process.env.SESSION_TOKEN });
# Python (noluyo_bot)
await bot.rest.create_application({"name": "Örnek Bot", "username": "ornek_bot", "description": "Sunucuya hoş geldin diyen bot"}, access_token=os.environ["SESSION_TOKEN"])

Yanıt (201)

{
  "application": {
    "id": "111540000000000000",
    "owner_id": "111400000000000500",
    "name": "Örnek Bot",
    "description": "Sunucuya hoş geldin diyen bot",
    "public": false,
    "verified": false,
    "bot": {
      "id": "111540000000000001",
      "username": "ornek_bot",
      "display_name": "Örnek Bot",
      "avatar": null,
      "cosmetics": null,
      "bot": true
    },
    "created_at": "2026-11-04T19:00:08.312Z",
    "privileged_intents": 0,
    "approved_intents": 0,
    "guild_count": 0,
    "interactions_endpoint_url": null,
    "public_key": "3b6a27bcceb6a42d62a3a8d02a6f0d73653215771de243a63ac048a18b59da29",
    "redirect_uris": [],
    "oauth_public": false,
    "privacy_url": null,
    "terms_url": null,
    "has_oauth_secret": false,
    "listed": false,
    "listing_category": null,
    "listing_text": null,
    "support_url": null,
    "website_url": null,
    "install_permissions": "0"
  },
  "token": "<BOT_TOKEN>"
}

Hata kodları

  • HTTP 400: validation_failed, invalid_body, max_applications
  • HTTP 401: unauthorized
  • HTTP 403: guest_not_allowed, email_not_verified, bot_developer_required, developer_terms_required, bot_forbidden, temporarily_banned
  • HTTP 413: body_too_large
  • HTTP 429: rate_limited
  • HTTP 503: maintenance

Geliştirici sözleşmesini kabul et (acceptDeveloperTerms)

POST https://noluyo.net/api/v1/applications/developer-terms (POST /applications/developer-terms)

Geliştirici portalı bu rotayı, bot token'ıyla değil, bir kişinin oturumuyla (Authorization: Bearer) kullanır. Hesabın /yasal/gelistirici-sozlesmesi adresindeki geliştirici sözleşmesini kabul ettiğini kaydeder. Platform açıldıktan sonra hesabın ilk uygulamasını oluşturmadan önce buna ihtiyacı vardır. version sözleşmenin güncel sürümü, 1 olmalıdır; yeniden kabul etmek bir şey değiştirmez.

  • Kimlik: Yalnızca kullanıcı oturumu (bot token'ı reddedilir)

Gövde alanları

AlanTürZorunluAçıklama
versionintegerevetSözleşmenin güncel sürümü.

Örnek çağrılar

curl -X POST "https://noluyo.net/api/v1/applications/developer-terms" \
  -H "Authorization: Bearer $SESSION_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"version":1}'
// JavaScript (noluyo-bot)
await bot.rest.acceptDeveloperTerms({ version: 1 }, { accessToken: process.env.SESSION_TOKEN });
# Python (noluyo_bot)
await bot.rest.accept_developer_terms({"version": 1}, access_token=os.environ["SESSION_TOKEN"])

Yanıt (204)

Yanıt gövdesi yok.

Hata kodları

  • HTTP 400: validation_failed, invalid_body
  • HTTP 401: unauthorized
  • HTTP 403: bot_forbidden, temporarily_banned
  • HTTP 413: body_too_large
  • HTTP 429: rate_limited
  • HTTP 503: maintenance

Uygulamanı getir (getApplication)

GET https://noluyo.net/api/v1/applications/{application_id} (GET /applications/{application_id})

Geliştirici portalı bu rotayı, bot token'ıyla değil, bir kişinin oturumuyla (Authorization: Bearer) kullanır. Kendin yalnızca otomasyon için çağır. Hesabın uygulamalarından birini döndürür. Başkasınınki, herkese açık olsa bile unknown_application verir.

  • Kimlik: Yalnızca kullanıcı oturumu (bot token'ı reddedilir)

Parametreler

AdKonumTürZorunluAçıklama
application_idpathstringevetUygulama ID'si.

Örnek çağrılar

curl -X GET "https://noluyo.net/api/v1/applications/111540000000000000" \
  -H "Authorization: Bearer $SESSION_TOKEN"
// JavaScript (noluyo-bot)
await bot.rest.getApplication("111540000000000000", { accessToken: process.env.SESSION_TOKEN });
# Python (noluyo_bot)
await bot.rest.get_application("111540000000000000", access_token=os.environ["SESSION_TOKEN"])

Yanıt (200)

{
  "id": "111540000000000000",
  "owner_id": "111400000000000500",
  "name": "Örnek Bot",
  "description": "Sunucuya hoş geldin diyen bot",
  "public": false,
  "verified": false,
  "bot": {
    "id": "111540000000000001",
    "username": "ornek_bot",
    "display_name": "Örnek Bot",
    "avatar": null,
    "cosmetics": null,
    "bot": true
  },
  "created_at": "2026-11-04T19:00:08.312Z",
  "privileged_intents": 0,
  "approved_intents": 0,
  "guild_count": 0,
  "interactions_endpoint_url": null,
  "public_key": "3b6a27bcceb6a42d62a3a8d02a6f0d73653215771de243a63ac048a18b59da29",
  "redirect_uris": [],
  "oauth_public": false,
  "privacy_url": null,
  "terms_url": null,
  "has_oauth_secret": false,
  "listed": false,
  "listing_category": null,
  "listing_text": null,
  "support_url": null,
  "website_url": null,
  "install_permissions": "0"
}

Hata kodları

  • HTTP 401: unauthorized
  • HTTP 403: bot_forbidden, temporarily_banned
  • HTTP 404: unknown_application
  • HTTP 429: rate_limited
  • HTTP 503: maintenance

Uygulamanı güncelle (updateApplication)

PATCH https://noluyo.net/api/v1/applications/{application_id} (PATCH /applications/{application_id})

Geliştirici portalı bu rotayı, bot token'ıyla değil, bir kişinin oturumuyla (Authorization: Bearer) kullanır. Kendin yalnızca otomasyon için çağır. Yalnızca gönderilen alanları değiştirir. Yeni ad, botun görünen adı da olur. public true, başkalarının botu kendi sunucularına eklemesine izin verir. description null açıklamayı siler. interactions_endpoint_url her şeyden önce test edilir; test geçmezse istekteki hiçbir şey kaydedilmez.

  • Kimlik: Yalnızca kullanıcı oturumu (bot token'ı reddedilir)

Parametreler

AdKonumTürZorunluAçıklama
application_idpathstringevetUygulama ID'si.

Gövde alanları

AlanTürZorunluAçıklama
namestring-(1–32)
descriptionstring | null-(<= 400)
publicboolean-
privileged_intentsinteger-Açılacak ayrıcalıklı intent'ler: 2, 256 ve 32768'in herhangi bir toplamı. 100 sunucudan sonra henüz onaylanmamış bir bit intent_approval_required ile reddedilir; kapatmak her zaman çalışır.
interactions_endpoint_urlstring | null-Botunun etkileşimler için https adresi. Kaydetmeden önce N'oluyo iki PING isteği yollar: doğru imzalıya 200 {"type":1}, yanlış imzalıya 401 dönmeli. İstek bunu bekler, en çok 6 saniye kadar; dakikada en çok 5 test. null gateway'e döner. Nasıl yapıldığını HTTP teslim rehberi anlatır. (<= 2048)
redirect_urisstring[]-Kayıtlı OAuth2 yönlendirme adresleri. (<= 10)
oauth_publicboolean-İstemci gizli anahtarı olmadan PKCE token değişimine izin ver.
privacy_urlstring | null-HTTPS gizlilik metni adresi.
terms_urlstring | null-HTTPS kullanım koşulları adresi.
listing_categorystring | null-Bot rehberi kategorisi. (moderation, music, games, utility, fun, social, other, )
listing_textstring | null-Kısa rehber kartı özeti. (<= 160)
support_urlstring | null-HTTPS destek adresi.
website_urlstring | null-HTTPS web sitesi adresi.
install_permissionsstring-Önerilen kurulum izin bitleri (ondalık metin).

Örnek çağrılar

curl -X PATCH "https://noluyo.net/api/v1/applications/111540000000000000" \
  -H "Authorization: Bearer $SESSION_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"public":true}'
// JavaScript (noluyo-bot)
await bot.rest.updateApplication("111540000000000000", { public: true }, { accessToken: process.env.SESSION_TOKEN });
# Python (noluyo_bot)
await bot.rest.update_application("111540000000000000", {"public": True}, access_token=os.environ["SESSION_TOKEN"])

Yanıt (200)

{
  "id": "111540000000000000",
  "owner_id": "111400000000000500",
  "name": "Yeni Ad",
  "description": "Sunucuya hoş geldin diyen bot",
  "public": true,
  "verified": false,
  "bot": {
    "id": "111540000000000001",
    "username": "ornek_bot",
    "display_name": "Yeni Ad",
    "avatar": null,
    "cosmetics": null,
    "bot": true
  },
  "created_at": "2026-11-04T19:00:08.312Z",
  "privileged_intents": 0,
  "approved_intents": 0,
  "guild_count": 0,
  "interactions_endpoint_url": null,
  "public_key": "3b6a27bcceb6a42d62a3a8d02a6f0d73653215771de243a63ac048a18b59da29",
  "redirect_uris": [],
  "oauth_public": false,
  "privacy_url": null,
  "terms_url": null,
  "has_oauth_secret": false,
  "listed": false,
  "listing_category": null,
  "listing_text": null,
  "support_url": null,
  "website_url": null,
  "install_permissions": "0"
}

Hata kodları

  • HTTP 400: validation_failed, invalid_body, intent_approval_required, endpoint_not_allowed, endpoint_unreachable, endpoint_bad_response, endpoint_no_signature_check
  • HTTP 401: unauthorized
  • HTTP 403: bot_forbidden, temporarily_banned
  • HTTP 404: unknown_application
  • HTTP 413: body_too_large
  • HTTP 429: rate_limited
  • HTTP 503: maintenance

Uygulamanı sil (deleteApplication)

DELETE https://noluyo.net/api/v1/applications/{application_id} (DELETE /applications/{application_id})

Geliştirici portalı bu rotayı, bot token'ıyla değil, bir kişinin oturumuyla (Authorization: Bearer) kullanır. Kendin yalnızca otomasyon için çağır. Uygulamayı ve bot hesabını siler. Token hemen çalışmaz olur.

  • Kimlik: Yalnızca kullanıcı oturumu (bot token'ı reddedilir)

Parametreler

AdKonumTürZorunluAçıklama
application_idpathstringevetUygulama ID'si.

Örnek çağrılar

curl -X DELETE "https://noluyo.net/api/v1/applications/111540000000000000" \
  -H "Authorization: Bearer $SESSION_TOKEN"
// JavaScript (noluyo-bot)
await bot.rest.deleteApplication("111540000000000000", { accessToken: process.env.SESSION_TOKEN });
# Python (noluyo_bot)
await bot.rest.delete_application("111540000000000000", access_token=os.environ["SESSION_TOKEN"])

Yanıt (204)

Yanıt gövdesi yok.

Hata kodları

  • HTTP 401: unauthorized
  • HTTP 403: bot_forbidden, temporarily_banned
  • HTTP 404: unknown_application
  • HTTP 429: rate_limited
  • HTTP 503: maintenance

Bot token'ını yenile (resetApplicationToken)

POST https://noluyo.net/api/v1/applications/{application_id}/token (POST /applications/{application_id}/token)

Geliştirici portalı bu rotayı, bot token'ıyla değil, bir kişinin oturumuyla (Authorization: Bearer) kullanır. Kendin yalnızca otomasyon için çağır. Bot token'ını yeniler: eskisi hemen çalışmaz olur, yenisi yalnızca bu yanıtta gösterilir. İstek gövdesi yoktur.

  • Kimlik: Yalnızca kullanıcı oturumu (bot token'ı reddedilir)

Parametreler

AdKonumTürZorunluAçıklama
application_idpathstringevetUygulama ID'si.

Örnek çağrılar

curl -X POST "https://noluyo.net/api/v1/applications/111540000000000000/token" \
  -H "Authorization: Bearer $SESSION_TOKEN"
// JavaScript (noluyo-bot)
await bot.rest.resetApplicationToken("111540000000000000", { accessToken: process.env.SESSION_TOKEN });
# Python (noluyo_bot)
await bot.rest.reset_application_token("111540000000000000", access_token=os.environ["SESSION_TOKEN"])

Yanıt (200)

{
  "token": "<BOT_TOKEN>"
}

Hata kodları

  • HTTP 401: unauthorized
  • HTTP 403: bot_forbidden, temporarily_banned
  • HTTP 404: unknown_application
  • HTTP 429: rate_limited
  • HTTP 503: maintenance

Adresinin teslim günlüğünü oku (getEndpointDeliveries)

GET https://noluyo.net/api/v1/applications/{application_id}/endpoint/deliveries (GET /applications/{application_id}/endpoint/deliveries)

Geliştirici portalı bu rotayı, bot token'ıyla değil, bir kişinin oturumuyla (Authorization: Bearer) kullanır. Kendin yalnızca otomasyon için çağır. Etkileşim adresine yapılan son teslimleri ve çok hatadan sonra N'oluyo'nun onu aramayı bırakıp bırakmadığını gösterir. İçinde kişi ya da içerik yoktur.

  • Kimlik: Yalnızca kullanıcı oturumu (bot token'ı reddedilir)

Parametreler

AdKonumTürZorunluAçıklama
application_idpathstringevetUygulama ID'si.

Örnek çağrılar

curl "https://noluyo.net/api/v1/applications/111540000000000000/endpoint/deliveries" \
  -H "Authorization: Bearer $SESSION_TOKEN"
// JavaScript (noluyo-bot)
await bot.rest.getEndpointDeliveries("111540000000000000", { accessToken: process.env.SESSION_TOKEN });
# Python (noluyo_bot)
await bot.rest.get_endpoint_deliveries("111540000000000000", access_token=os.environ["SESSION_TOKEN"])

Yanıt (200)

{
  "deliveries": [
    {
      "at": "2026-11-08T14:02:11.204Z",
      "type": 2,
      "status": 0,
      "took_ms": 3000,
      "result": "timeout"
    },
    {
      "at": "2026-11-08T14:01:40.917Z",
      "type": 3,
      "status": 200,
      "took_ms": 84,
      "result": "ok"
    }
  ],
  "open": false
}

Hata kodları

  • HTTP 401: unauthorized
  • HTTP 403: bot_forbidden, temporarily_banned
  • HTTP 404: unknown_application
  • HTTP 429: rate_limited
  • HTTP 503: maintenance

Eklemeden önce uygulamayı gör (getPublicApplication)

GET https://noluyo.net/api/v1/applications/{application_id}/public (GET /applications/{application_id}/public)

Geliştirici portalı bu rotayı, bot token'ıyla değil, bir kişinin oturumuyla (Authorization: Bearer) kullanır. Kendin yalnızca otomasyon için çağır. Sunucuya ekleme ekranında görünen bilgiler; sahibi yer almaz. Özel uygulamayı yalnızca sahibi görür; başkaları için, botu veya sahibi kapatılmış ya da silinmiş uygulama gibi unknown_application döner. icon, botun avatar hash'idir.

  • Kimlik: Yalnızca kullanıcı oturumu (bot token'ı reddedilir)

Parametreler

AdKonumTürZorunluAçıklama
application_idpathstringevetUygulama ID'si.

Örnek çağrılar

curl -X GET "https://noluyo.net/api/v1/applications/111540000000000000/public" \
  -H "Authorization: Bearer $SESSION_TOKEN"
// JavaScript (noluyo-bot)
await bot.rest.getPublicApplication("111540000000000000", { accessToken: process.env.SESSION_TOKEN });
# Python (noluyo_bot)
await bot.rest.get_public_application("111540000000000000", access_token=os.environ["SESSION_TOKEN"])

Yanıt (200)

{
  "id": "111540000000000000",
  "name": "Örnek Bot",
  "description": "Sunucuya hoş geldin diyen bot",
  "icon": null,
  "bot": {
    "id": "111540000000000001",
    "username": "ornek_bot",
    "display_name": "Örnek Bot",
    "avatar": null,
    "cosmetics": null,
    "bot": true
  },
  "public": true,
  "verified": false
}

Hata kodları

  • HTTP 401: unauthorized
  • HTTP 403: bot_forbidden, temporarily_banned
  • HTTP 404: unknown_application
  • HTTP 429: rate_limited
  • HTTP 503: maintenance

Botu sunucuya ekle (authorizeApplication)

POST https://noluyo.net/api/v1/applications/{application_id}/authorize (POST /applications/{application_id}/authorize)

Geliştirici portalı bu rotayı, bot token'ıyla değil, bir kişinin oturumuyla (Authorization: Bearer) kullanır. Kendin yalnızca otomasyon için çağır. Botu, çağıranın ManageGuild iznine sahip olduğu sunucuya ekler. Bot, doğrudan @everyone'ın üstünde, kendi adını taşıyan ve istenen izinlere sahip bir yönetilen rol alır; bu izinler çağıranda bulunmalıdır. Özel botu yalnızca sahibi ekleyebilir. Şimdilik sunucunun sahibi de kapalı döneme davet edilmiş bir hesap olmalıdır (aksi halde bots_closed). Henüz doğrulanmamış bir bot en çok 100 sunucuda olabilir.

  • Kimlik: Yalnızca kullanıcı oturumu (bot token'ı reddedilir)
  • İzinler: ManageGuild

Parametreler

AdKonumTürZorunluAçıklama
application_idpathstringevetUygulama ID'si.

Gövde alanları

AlanTürZorunluAçıklama
guild_idIDevet64 bitlik ID; yanıtta da istekte de her zaman metin olarak yazılır. ID'ler oluşturulma zamanına göre sıralanır.
permissionspermissions-Ondalık metin olarak izin bit alanı. Metin yerine sayı veya tanımlı olmayan bitler invalid_body verir.

Örnek çağrılar

curl -X POST "https://noluyo.net/api/v1/applications/111540000000000000/authorize" \
  -H "Authorization: Bearer $SESSION_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"guild_id":"111500000000000000","permissions":"68672"}'
// JavaScript (noluyo-bot)
await bot.rest.authorizeApplication("111540000000000000", { guild_id: "111500000000000000", permissions: "68672" }, { accessToken: process.env.SESSION_TOKEN });
# Python (noluyo_bot)
await bot.rest.authorize_application("111540000000000000", {"guild_id": "111500000000000000", "permissions": "68672"}, access_token=os.environ["SESSION_TOKEN"])

Yanıt (204)

Yanıt gövdesi yok.

Hata kodları

  • HTTP 400: invalid_body, bot_in_guild, bot_guild_limit, max_roles
  • HTTP 401: unauthorized
  • HTTP 403: bot_private, bots_closed, banned, missing_permissions, bot_forbidden, temporarily_banned
  • HTTP 404: unknown_application, unknown_guild
  • HTTP 413: body_too_large
  • HTTP 429: rate_limited
  • HTTP 503: maintenance

Botun resmini ayarla (setApplicationAvatar)

POST https://noluyo.net/api/v1/applications/{application_id}/avatar (POST /applications/{application_id}/avatar)

Geliştirici portalı bu rotayı, bot token'ıyla değil, bir kişinin oturumuyla (Authorization: Bearer) kullanır. Kendin yalnızca otomasyon için çağır. Botun avatarını multipart/form-data ile yükler; görsel file adlı parçada olur: PNG, JPEG, WebP veya GIF, en çok 5 MB (hareketli GIF 10 MB) ve 4096×4096 piksel. Uygulamayla yanıt verir.

  • Kimlik: Yalnızca kullanıcı oturumu (bot token'ı reddedilir)

Parametreler

AdKonumTürZorunluAçıklama
application_idpathstringevetUygulama ID'si.

Gövde alanları

AlanTürZorunluAçıklama
filestringevet

Örnek çağrılar

curl -X POST "https://noluyo.net/api/v1/applications/111540000000000000/avatar" \
  -H "Authorization: Bearer $SESSION_TOKEN" \
  -F "file=@avatar.png"
// JavaScript (noluyo-bot)
await bot.rest.setApplicationAvatar("111540000000000000", { name: "avatar.png", data: new Uint8Array(), contentType: "image/png" }, { accessToken: process.env.SESSION_TOKEN });
# Python (noluyo_bot)
await bot.rest.set_application_avatar("111540000000000000", file={"name": "avatar.png", "data": b"", "content_type": "image/png"}, access_token=os.environ["SESSION_TOKEN"])

Yanıt (200)

{
  "id": "111540000000000000",
  "owner_id": "111400000000000500",
  "name": "Örnek Bot",
  "description": "Sunucuya hoş geldin diyen bot",
  "public": false,
  "verified": false,
  "bot": {
    "id": "111540000000000001",
    "username": "ornek_bot",
    "display_name": "Örnek Bot",
    "avatar": "6f1c0a9d2b3e4f5a6b7c8d9e0f1a2b3c",
    "cosmetics": null,
    "bot": true
  },
  "created_at": "2026-11-04T19:00:08.312Z",
  "privileged_intents": 0,
  "approved_intents": 0,
  "guild_count": 0,
  "interactions_endpoint_url": null,
  "public_key": "3b6a27bcceb6a42d62a3a8d02a6f0d73653215771de243a63ac048a18b59da29"
}

Hata kodları

  • HTTP 400: invalid_image
  • HTTP 401: unauthorized
  • HTTP 403: bot_forbidden, temporarily_banned
  • HTTP 404: unknown_application
  • HTTP 413: image_too_large
  • HTTP 429: upload_quota, rate_limited
  • HTTP 503: maintenance

Botun resmini kaldır (deleteApplicationAvatar)

DELETE https://noluyo.net/api/v1/applications/{application_id}/avatar (DELETE /applications/{application_id}/avatar)

Geliştirici portalı bu rotayı, bot token'ıyla değil, bir kişinin oturumuyla (Authorization: Bearer) kullanır. Kendin yalnızca otomasyon için çağır. Botun avatarını kaldırır ve uygulamayla yanıt verir.

  • Kimlik: Yalnızca kullanıcı oturumu (bot token'ı reddedilir)

Parametreler

AdKonumTürZorunluAçıklama
application_idpathstringevetUygulama ID'si.

Örnek çağrılar

curl -X DELETE "https://noluyo.net/api/v1/applications/111540000000000000/avatar" \
  -H "Authorization: Bearer $SESSION_TOKEN"
// JavaScript (noluyo-bot)
await bot.rest.deleteApplicationAvatar("111540000000000000", { accessToken: process.env.SESSION_TOKEN });
# Python (noluyo_bot)
await bot.rest.delete_application_avatar("111540000000000000", access_token=os.environ["SESSION_TOKEN"])

Yanıt (200)

{
  "id": "111540000000000000",
  "owner_id": "111400000000000500",
  "name": "Örnek Bot",
  "description": "Sunucuya hoş geldin diyen bot",
  "public": false,
  "verified": false,
  "bot": {
    "id": "111540000000000001",
    "username": "ornek_bot",
    "display_name": "Örnek Bot",
    "avatar": null,
    "cosmetics": null,
    "bot": true
  },
  "created_at": "2026-11-04T19:00:08.312Z",
  "privileged_intents": 0,
  "approved_intents": 0,
  "guild_count": 0,
  "interactions_endpoint_url": null,
  "public_key": "3b6a27bcceb6a42d62a3a8d02a6f0d73653215771de243a63ac048a18b59da29"
}

Hata kodları

  • HTTP 401: unauthorized
  • HTTP 403: bot_forbidden, temporarily_banned
  • HTTP 404: unknown_application
  • HTTP 429: rate_limited
  • HTTP 503: maintenance

OAuth2 istemci gizli anahtarını yenile (resetOAuthSecret)

POST https://noluyo.net/api/v1/applications/{application_id}/oauth-secret (POST /applications/{application_id}/oauth-secret)

Geliştirici portalı bu rotayı, bot token'ıyla değil, bir kişinin oturumuyla (Authorization: Bearer) kullanır. Gizli istemcili uygulamalar için yeni bir OAuth2 istemci gizli anahtarı üretir; önceki anahtar hemen geçersiz olur, düz değer yalnızca bu yanıtta döner.

  • Kimlik: Yalnızca kullanıcı oturumu (bot token'ı reddedilir)

Parametreler

AdKonumTürZorunluAçıklama
application_idpathstringevetUygulama ID'si.

Örnek çağrılar

curl -X POST "https://noluyo.net/api/v1/applications/111540000000000000/oauth-secret" \
  -H "Authorization: Bearer $SESSION_TOKEN"
// JavaScript (noluyo-bot)
await bot.rest.resetOAuthSecret("111540000000000000", { accessToken: process.env.SESSION_TOKEN });
# Python (noluyo_bot)
await bot.rest.reset_oauth_secret("111540000000000000", access_token=os.environ["SESSION_TOKEN"])

Yanıt (200)

{
  "client_secret": "<CLIENT_SECRET>"
}

Hata kodları

  • HTTP 401: unauthorized
  • HTTP 403: bot_forbidden, temporarily_banned
  • HTTP 404: unknown_application
  • HTTP 429: rate_limited
  • HTTP 503: maintenance

Son doğrulama başvurusunu getir (getApplicationReview)

GET https://noluyo.net/api/v1/applications/{application_id}/review (GET /applications/{application_id}/review)

Bu uygulama için gönderilmiş son doğrulama başvurusunu döndürür; henüz başvuru yoksa {review: null} döner.

  • Kimlik: Yalnızca kullanıcı oturumu (bot token'ı reddedilir)

Parametreler

AdKonumTürZorunluAçıklama
application_idpathstringevetUygulama ID'si.

Örnek çağrılar

curl https://noluyo.net/api/v1/applications/21879167385600004/review \
  -H "Authorization: Bearer $USER_TOKEN"
// JavaScript (noluyo-bot)
await bot.rest.getApplicationReview("21879167385600004", { accessToken: process.env.SESSION_TOKEN });
# Python (noluyo_bot)
await bot.rest.get_application_review("21879167385600004", access_token=os.environ["SESSION_TOKEN"])

Yanıt (200)

{
  "review": {
    "id": "22104891204198401",
    "application_id": "21879167385600004",
    "status": "pending",
    "purpose": "Moderates spam and runs server polls.",
    "data_use": "Stores per-guild filter words and active poll tallies until closed.",
    "requested_intents": 32768,
    "want_listing": true,
    "note": null,
    "created_at": "2026-11-11T00:00:00Z",
    "decided_at": null
  }
}

Hata kodları

  • HTTP 401: unauthorized
  • HTTP 403: bot_forbidden, temporarily_banned
  • HTTP 404: unknown_application
  • HTTP 503: maintenance

Doğrulama başvurusu gönder (submitApplicationReview)

POST https://noluyo.net/api/v1/applications/{application_id}/review (POST /applications/{application_id}/review)

Uygulamayı doğrulama incelemesine gönderir (100 sunucu üstü, ölçekte ayrıcalıklı intent onayı ve bot rehberinde yer almak için gerekir). Herkese açık bot, açıklama, avatar, https gizlilik adresi, https destek adresi ve sahip hesabında açık iki adımlı doğrulama ister.

  • Kimlik: Yalnızca kullanıcı oturumu (bot token'ı reddedilir)

Parametreler

AdKonumTürZorunluAçıklama
application_idpathstringevetUygulama ID'si.

Gövde alanları

AlanTürZorunluAçıklama
purposestringevet(10–2000)
data_usestringevet(10–2000)
requested_intentsinteger-(= 0)
want_listingboolean-(= false)

Örnek çağrılar

curl -X POST https://noluyo.net/api/v1/applications/21879167385600004/review \
  -H "Authorization: Bearer $USER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"purpose":"Moderates spam and runs server polls.","data_use":"Stores per-guild filter words and active poll tallies.","requested_intents":32768,"want_listing":true}'
// JavaScript (noluyo-bot)
await bot.rest.submitApplicationReview("21879167385600004", { purpose: "Moderates spam and runs server polls.", data_use: "Stores per-guild filter words and active poll tallies.", requested_intents: 32768, want_listing: true }, { accessToken: process.env.SESSION_TOKEN });
# Python (noluyo_bot)
await bot.rest.submit_application_review("21879167385600004", {"purpose": "Moderates spam and runs server polls.", "data_use": "Stores per-guild filter words and active poll tallies.", "requested_intents": 32768, "want_listing": True}, access_token=os.environ["SESSION_TOKEN"])

Yanıt (201)

{
  "id": "22104891204198401",
  "application_id": "21879167385600004",
  "status": "pending",
  "purpose": "Moderates spam and runs server polls.",
  "data_use": "Stores per-guild filter words and active poll tallies until closed.",
  "requested_intents": 32768,
  "want_listing": true,
  "note": null,
  "created_at": "2026-11-11T00:00:00Z",
  "decided_at": null
}

Hata kodları

  • HTTP 400: review_requirements, review_pending, validation_failed, invalid_body
  • HTTP 401: unauthorized
  • HTTP 403: bot_forbidden, temporarily_banned
  • HTTP 404: unknown_application
  • HTTP 429: rate_limited
  • HTTP 503: maintenance