İçeriğe geç
N'oluyo
REST referansı

Uygulamalar

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

Son güncelleme:

Uygulamalarını listele

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 bir kişinin oturumu; bot token'ı reddedilir

Örnek istek

curl -X GET "https://noluyo.net/api/v1/applications" \
  -H "Authorization: Bearer $SESSION_TOKEN"

Örnek yanıt

200 Başarılı

JSON
[
  {
    "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"
  }
]

Hatalar

Uygulama oluştur

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 bir kişinin oturumu; bot token'ı reddedilir

Gövde alanları

AdTürAçıklama
namezorunlustring1–32
usernamezorunlustring4–32
descriptionstring | null≤ 400

Örnek istek

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

Örnek gövde

application/json
{
  "name": "Örnek Bot",
  "username": "ornek_bot",
  "description": "Sunucuya hoş geldin diyen bot"
}

Örnek yanıt

201 Başarılı

JSON
{
  "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>"
}

Hatalar

Geliştirici sözleşmesini kabul et

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 bir kişinin oturumu; bot token'ı reddedilir

Gövde alanları

AdTürAçıklama
versionzorunluinteger

Sözleşmenin güncel sürümü.

Örnek istek

curl -X POST "https://noluyo.net/api/v1/applications/developer-terms" \
  -H "Authorization: Bearer $SESSION_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"version":1}'

Örnek gövde

application/json
{
  "version": 1
}

Örnek yanıt

204 Başarılı; yanıtın gövdesi yok.

Hatalar

Uygulamanı getir

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 bir kişinin oturumu; bot token'ı reddedilir

Parametreler

AdTürAçıklama
application_idzorunlustringAdreste

Uygulama ID'si.

Örnek istek

curl -X GET "https://noluyo.net/api/v1/applications/111540000000000000" \
  -H "Authorization: Bearer $SESSION_TOKEN"

Örnek yanıt

200 Başarılı

JSON
{
  "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"
}

Hatalar

Uygulamanı güncelle

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 bir kişinin oturumu; bot token'ı reddedilir

Parametreler

AdTürAçıklama
application_idzorunlustringAdreste

Uygulama ID'si.

Gövde alanları

AdTürAçıklama
namestring1–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 istek

curl -X PATCH "https://noluyo.net/api/v1/applications/111540000000000000" \
  -H "Authorization: Bearer $SESSION_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"public":true}'

Örnek gövde

application/json
{
  "name": "Yeni Ad",
  "public": true
}

Örnek yanıt

200 Başarılı

JSON
{
  "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"
}

Hatalar

Uygulamanı sil

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 bir kişinin oturumu; bot token'ı reddedilir

Parametreler

AdTürAçıklama
application_idzorunlustringAdreste

Uygulama ID'si.

Örnek istek

curl -X DELETE "https://noluyo.net/api/v1/applications/111540000000000000" \
  -H "Authorization: Bearer $SESSION_TOKEN"

Örnek yanıt

204 Başarılı; yanıtın gövdesi yok.

Hatalar

Bot token'ını yenile

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 bir kişinin oturumu; bot token'ı reddedilir

Parametreler

AdTürAçıklama
application_idzorunlustringAdreste

Uygulama ID'si.

Örnek istek

curl -X POST "https://noluyo.net/api/v1/applications/111540000000000000/token" \
  -H "Authorization: Bearer $SESSION_TOKEN"

Örnek yanıt

200 Başarılı

JSON
{
  "token": "<BOT_TOKEN>"
}

Hatalar

Adresinin teslim günlüğünü oku

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 bir kişinin oturumu; bot token'ı reddedilir

Parametreler

AdTürAçıklama
application_idzorunlustringAdreste

Uygulama ID'si.

Örnek istek

curl "https://noluyo.net/api/v1/applications/111540000000000000/endpoint/deliveries" \
  -H "Authorization: Bearer $SESSION_TOKEN"

Örnek yanıt

200 Başarılı

JSON
{
  "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
}

Hatalar

Eklemeden önce uygulamayı gör

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 bir kişinin oturumu; bot token'ı reddedilir

Parametreler

AdTürAçıklama
application_idzorunlustringAdreste

Uygulama ID'si.

Örnek istek

curl -X GET "https://noluyo.net/api/v1/applications/111540000000000000/public" \
  -H "Authorization: Bearer $SESSION_TOKEN"

Örnek yanıt

200 Başarılı

JSON
{
  "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
}

Hatalar

Botu sunucuya ekle

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 bir kişinin oturumu; bot token'ı reddedilir
İzinler
ManageGuild

Parametreler

AdTürAçıklama
application_idzorunlustringAdreste

Uygulama ID'si.

Gövde alanları

AdTürAçıklama
guild_idzorunluID

64 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 istek

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

Örnek gövde

application/json
{
  "guild_id": "111500000000000000",
  "permissions": "68672"
}

Örnek yanıt

204 Başarılı; yanıtın gövdesi yok.

Hatalar

Botun resmini ayarla

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 bir kişinin oturumu; bot token'ı reddedilir

Parametreler

AdTürAçıklama
application_idzorunlustringAdreste

Uygulama ID'si.

Gövde alanları

AdTürAçıklama
filezorunlustring

Örnek istek

curl -X POST "https://noluyo.net/api/v1/applications/111540000000000000/avatar" \
  -H "Authorization: Bearer $SESSION_TOKEN" \
  -F "file=@avatar.png"

Örnek gövde

multipart/form-data
{
  "file": "(avatar.png)"
}

Örnek yanıt

200 Başarılı

JSON
{
  "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"
}

Hatalar

Botun resmini kaldır

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 bir kişinin oturumu; bot token'ı reddedilir

Parametreler

AdTürAçıklama
application_idzorunlustringAdreste

Uygulama ID'si.

Örnek istek

curl -X DELETE "https://noluyo.net/api/v1/applications/111540000000000000/avatar" \
  -H "Authorization: Bearer $SESSION_TOKEN"

Örnek yanıt

200 Başarılı

JSON
{
  "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"
}

Hatalar

OAuth2 istemci gizli anahtarını yenile

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 bir kişinin oturumu; bot token'ı reddedilir

Parametreler

AdTürAçıklama
application_idzorunlustringAdreste

Uygulama ID'si.

Örnek istek

curl -X POST "https://noluyo.net/api/v1/applications/111540000000000000/oauth-secret" \
  -H "Authorization: Bearer $SESSION_TOKEN"

Örnek yanıt

200 Başarılı

JSON
{
  "client_secret": "<CLIENT_SECRET>"
}

Hatalar

Son doğrulama başvurusunu getir

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 bir kişinin oturumu; bot token'ı reddedilir

Parametreler

AdTürAçıklama
application_idzorunlustringAdreste

Uygulama ID'si.

Örnek istek

curl https://noluyo.net/api/v1/applications/21879167385600004/review \
  -H "Authorization: Bearer $USER_TOKEN"

Örnek yanıt

200 Başarılı

JSON
{
  "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
  }
}

Hatalar

Doğrulama başvurusu gönder

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 bir kişinin oturumu; bot token'ı reddedilir

Parametreler

AdTürAçıklama
application_idzorunlustringAdreste

Uygulama ID'si.

Gövde alanları

AdTürAçıklama
purposezorunlustring10–2000
data_usezorunlustring10–2000
requested_intentsinteger= 0
want_listingboolean= false

Örnek istek

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

Örnek gövde

application/json
{
  "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
}

Örnek yanıt

201 Başarılı

JSON
{
  "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
}

Hatalar