REST referansı

Komutlar

Botun sunduğu komutlar: eğik çizgi komutları, kullanıcı ve mesaj menüleri; global ya da bir sunucuya özel. Kişinin oturumu, sahibi olduğu uygulamalar için aynı rotalara ulaşır.

Son güncelleme: 11 Kasım 2026

.md indir Markdown aç .html indirTam PDF

Global komutları listele

GET/applications/{application_id}/commands

Uygulamanın global komutlarını seçenekleriyle listeler. Global komutlar botun bulunduğu her sunucuda çalışır.

Kimlik: Bot token'ı (bir kişinin oturumu da olur)
Hız sınırı: read 30 istek / 5 sn

Parametreler

Ad	Tür	Açıklama
`application_id`zorunlu	string	Adreste Uygulama ID'si.

Örnek istek

curl -X GET "https://noluyo.net/api/v1/applications/111540000000000000/commands" \
  -H "Authorization: Bot $BOT_TOKEN"

Örnek yanıt

200 Başarılı

JSON

[
  {
    "id": "111560000000000000",
    "application_id": "111540000000000000",
    "version": "111560000000000001",
    "guild_id": null,
    "type": 1,
    "name": "selam",
    "name_localizations": {
      "en": "hello"
    },
    "description": "Birini selamlar",
    "description_localizations": {
      "en": "Greets someone"
    },
    "options": [
      {
        "type": 6,
        "name": "kisi",
        "name_localizations": {
          "en": "person"
        },
        "description": "Selamlanacak kişi",
        "description_localizations": {
          "en": "The person to greet"
        },
        "required": true
      }
    ],
    "default_member_permissions": null,
    "contexts": [
      0,
      1
    ]
  }
]

Hatalar

Durum	Kodlar
401	unauthorized
403	temporarily_banned
404	unknown_application
429	rate_limited
503	maintenance

Global komutların hepsini değiştir

PUT/applications/{application_id}/commands

Listeyi global komutlarının tamamı yapar, tek adımda. Türü ve adı eşleşen komutun kimliği kalır; listede olmayanlar silinir; boş liste hepsini siler. Bir tanım geçersizse hiçbir şey değişmez. Günlük sınıra yalnız yeni komutlar sayılır; bunu bot açılırken gönder. Global komutlar botun bulunduğu her sunucuda çalışır.

Kimlik: Bot token'ı (bir kişinin oturumu da olur)
Hız sınırı: command 5 istek / 20 sn

Parametreler

Ad	Tür	Açıklama
`application_id`zorunlu	string	Adreste Uygulama ID'si.

Örnek istek

curl -X PUT "https://noluyo.net/api/v1/applications/111540000000000000/commands" \
  -H "Authorization: Bot $BOT_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '[{"name":"selam","description":"Birini selamlar","options":[{"type":6,"name":"kisi","description":"Selamlanacak kişi","required":true}]},{"type":2,"name":"Profili aç"}]'

Örnek gövde

application/json

[
  {
    "name": "selam",
    "name_localizations": {
      "en": "hello"
    },
    "description": "Birini selamlar",
    "description_localizations": {
      "en": "Greets someone"
    },
    "options": [
      {
        "type": 6,
        "name": "kisi",
        "name_localizations": {
          "en": "person"
        },
        "description": "Selamlanacak kişi",
        "description_localizations": {
          "en": "The person to greet"
        },
        "required": true
      }
    ]
  },
  {
    "type": 2,
    "name": "Profili aç"
  }
]

Örnek yanıt

200 Başarılı

JSON

[
  {
    "id": "111560000000000000",
    "application_id": "111540000000000000",
    "version": "111560000000000001",
    "guild_id": null,
    "type": 1,
    "name": "selam",
    "name_localizations": {
      "en": "hello"
    },
    "description": "Birini selamlar",
    "description_localizations": {
      "en": "Greets someone"
    },
    "options": [
      {
        "type": 6,
        "name": "kisi",
        "name_localizations": {
          "en": "person"
        },
        "description": "Selamlanacak kişi",
        "description_localizations": {
          "en": "The person to greet"
        },
        "required": true
      }
    ],
    "default_member_permissions": null,
    "contexts": [
      0,
      1
    ]
  }
]

Hatalar

Durum	Kodlar
400	validation_failed invalid_body max_commands
401	unauthorized
403	temporarily_banned
404	unknown_application
413	body_too_large
429	rate_limited
503	maintenance

Global komutu oluştur

POST/applications/{application_id}/commands

Komut ekler. Aynı tür ve adda komut varsa tanımı değişir, kimliği kalır: 201 yerine 200 döner. Yeni komut, kapsam başına günde 200 yeni komuta sayılır; güncelleme sayılmaz. Kişiler değişikliği en geç 60 saniyede görür. Global komutlar botun bulunduğu her sunucuda çalışır.

Kimlik: Bot token'ı (bir kişinin oturumu da olur)
Hız sınırı: command 5 istek / 20 sn

Parametreler

Ad	Tür	Açıklama
`application_id`zorunlu	string	Adreste Uygulama ID'si.

Gövde alanları

Ad	Tür	Açıklama
`type`	integer	1 eğik çizgi komutu (varsayılan), 2 kullanıcı menüsü, 3 mesaj menüsü. 1, 2, 3
`name`zorunlu	string	Eğik çizgi komutu: küçük harf, rakam, - ve _. Menü: en çok 32 karakter, boşluk ve büyük harf olabilir. 1–32
`name_localizations`	object	Adın tr ve en karşılığı.
`description`	string	Eğik çizgi komutunda zorunlu, menüde boş. ≤ 100
`description_localizations`	object	Açıklamanın tr ve en karşılığı.
`options`	CommandOption[]	Yalnız eğik çizgi komutunda. ≤ 25
`default_member_permissions`	permissions \| null	Sunucu kural koyana dek kimin kullanacağı: null herkes, "0" yalnız sahip ve yöneticiler, değilse bu bitlerin hepsine sahip üyeler.
`contexts`	integer[]	Nerede çalıştığı: 0 sunucu kanalı, 1 kişinin botunla açtığı DM. Gönderilmezse [0, 1]. Her biri en çok bir kez. `default_member_permissions` dolu komut bu ne derse desin DM'de çalışmaz: orada kimsenin izin biti yok. 1–2

Örnek istek

curl -X POST "https://noluyo.net/api/v1/applications/111540000000000000/commands" \
  -H "Authorization: Bot $BOT_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"name":"selam","description":"Birini selamlar","options":[{"type":6,"name":"kisi","description":"Selamlanacak kişi","required":true}]}'

Örnek gövde

application/json

{
  "name": "selam",
  "name_localizations": {
    "en": "hello"
  },
  "description": "Birini selamlar",
  "description_localizations": {
    "en": "Greets someone"
  },
  "options": [
    {
      "type": 6,
      "name": "kisi",
      "name_localizations": {
        "en": "person"
      },
      "description": "Selamlanacak kişi",
      "description_localizations": {
        "en": "The person to greet"
      },
      "required": true
    }
  ]
}

Örnek yanıt

200 Başarılı

JSON

{
  "id": "111560000000000000",
  "application_id": "111540000000000000",
  "version": "111560000000000001",
  "guild_id": null,
  "type": 1,
  "name": "selam",
  "name_localizations": {
    "en": "hello"
  },
  "description": "Birini selamlar",
  "description_localizations": {
    "en": "Greets someone"
  },
  "options": [
    {
      "type": 6,
      "name": "kisi",
      "name_localizations": {
        "en": "person"
      },
      "description": "Selamlanacak kişi",
      "description_localizations": {
        "en": "The person to greet"
      },
      "required": true
    }
  ],
  "default_member_permissions": null,
  "contexts": [
    0,
    1
  ]
}

Hatalar

Durum	Kodlar
400	validation_failed invalid_body max_commands
401	unauthorized
403	temporarily_banned
404	unknown_application
413	body_too_large
429	rate_limited
503	maintenance

Global komutu getir

GET/applications/{application_id}/commands/{command_id}

Global komutlarından birini döner. Global komutlar botun bulunduğu her sunucuda çalışır.

Kimlik: Bot token'ı (bir kişinin oturumu da olur)
Hız sınırı: read 30 istek / 5 sn

Parametreler

Ad	Tür	Açıklama
`application_id`zorunlu	string	Adreste Uygulama ID'si.
`command_id`zorunlu	string	Adreste Komut ID'si.

Örnek istek

curl -X GET "https://noluyo.net/api/v1/applications/111540000000000000/commands/111560000000000000" \
  -H "Authorization: Bot $BOT_TOKEN"

Örnek yanıt

200 Başarılı

JSON

{
  "id": "111560000000000000",
  "application_id": "111540000000000000",
  "version": "111560000000000001",
  "guild_id": null,
  "type": 1,
  "name": "selam",
  "name_localizations": {
    "en": "hello"
  },
  "description": "Birini selamlar",
  "description_localizations": {
    "en": "Greets someone"
  },
  "options": [
    {
      "type": 6,
      "name": "kisi",
      "name_localizations": {
        "en": "person"
      },
      "description": "Selamlanacak kişi",
      "description_localizations": {
        "en": "The person to greet"
      },
      "required": true
    }
  ],
  "default_member_permissions": null,
  "contexts": [
    0,
    1
  ]
}

Hatalar

Durum	Kodlar
401	unauthorized
403	temporarily_banned
404	unknown_application unknown_command
429	rate_limited
503	maintenance

Global komutu düzenle

PATCH/applications/{application_id}/commands/{command_id}

Gönderilen alanları değiştirir, diğerleri kalır. type değişmez: komutu silip yeniden oluştur. version değişir. Global komutlar botun bulunduğu her sunucuda çalışır.

Kimlik: Bot token'ı (bir kişinin oturumu da olur)
Hız sınırı: command 5 istek / 20 sn

Parametreler

Ad	Tür	Açıklama
`application_id`zorunlu	string	Adreste Uygulama ID'si.
`command_id`zorunlu	string	Adreste Komut ID'si.

Gövde alanları

Ad	Tür	Açıklama
`type`	integer	1 eğik çizgi komutu (varsayılan), 2 kullanıcı menüsü, 3 mesaj menüsü. 1, 2, 3
`name`zorunlu	string	Eğik çizgi komutu: küçük harf, rakam, - ve _. Menü: en çok 32 karakter, boşluk ve büyük harf olabilir. 1–32
`name_localizations`	object	Adın tr ve en karşılığı.
`description`	string	Eğik çizgi komutunda zorunlu, menüde boş. ≤ 100
`description_localizations`	object	Açıklamanın tr ve en karşılığı.
`options`	CommandOption[]	Yalnız eğik çizgi komutunda. ≤ 25
`default_member_permissions`	permissions \| null	Sunucu kural koyana dek kimin kullanacağı: null herkes, "0" yalnız sahip ve yöneticiler, değilse bu bitlerin hepsine sahip üyeler.
`contexts`	integer[]	Nerede çalıştığı: 0 sunucu kanalı, 1 kişinin botunla açtığı DM. Gönderilmezse [0, 1]. Her biri en çok bir kez. `default_member_permissions` dolu komut bu ne derse desin DM'de çalışmaz: orada kimsenin izin biti yok. 1–2

Örnek istek

curl -X PATCH "https://noluyo.net/api/v1/applications/111540000000000000/commands/111560000000000000" \
  -H "Authorization: Bot $BOT_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"description":"Birine merhaba der"}'

Örnek gövde

application/json

{
  "description": "Birine merhaba der"
}

Örnek yanıt

200 Başarılı

JSON

{
  "id": "111560000000000000",
  "application_id": "111540000000000000",
  "version": "111560000000000001",
  "guild_id": null,
  "type": 1,
  "name": "selam",
  "name_localizations": {
    "en": "hello"
  },
  "description": "Birini selamlar",
  "description_localizations": {
    "en": "Greets someone"
  },
  "options": [
    {
      "type": 6,
      "name": "kisi",
      "name_localizations": {
        "en": "person"
      },
      "description": "Selamlanacak kişi",
      "description_localizations": {
        "en": "The person to greet"
      },
      "required": true
    }
  ],
  "default_member_permissions": null,
  "contexts": [
    0,
    1
  ]
}

Hatalar

Durum	Kodlar
400	validation_failed invalid_body
401	unauthorized
403	temporarily_banned
404	unknown_application unknown_command
413	body_too_large
429	rate_limited
503	maintenance

Global komutu sil

DELETE/applications/{application_id}/commands/{command_id}

Global komutlarından birini izin kurallarıyla siler. Global komutlar botun bulunduğu her sunucuda çalışır.

Kimlik: Bot token'ı (bir kişinin oturumu da olur)
Hız sınırı: command 5 istek / 20 sn

Parametreler

Ad	Tür	Açıklama
`application_id`zorunlu	string	Adreste Uygulama ID'si.
`command_id`zorunlu	string	Adreste Komut ID'si.

Örnek istek

curl -X DELETE "https://noluyo.net/api/v1/applications/111540000000000000/commands/111560000000000000" \
  -H "Authorization: Bot $BOT_TOKEN"

Örnek yanıt

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

Hatalar

Durum	Kodlar
401	unauthorized
403	temporarily_banned
404	unknown_application unknown_command
429	rate_limited
503	maintenance

Sunucu komutlarını listele

GET/applications/{application_id}/guilds/{guild_id}/commands

Uygulamanın bu sunucunun komutlarını seçenekleriyle listeler. Botun bir sunucuya özel komutları. Bot o sunucuda üye olmalı; değilse yanıt missing_access olur.

Kimlik: Bot token'ı (bir kişinin oturumu da olur)
Hız sınırı: read 30 istek / 5 sn

Parametreler

Ad	Tür	Açıklama
`application_id`zorunlu	string	Adreste Uygulama ID'si.
`guild_id`zorunlu	string	Adreste Sunucu ID'si.

Örnek istek

curl -X GET "https://noluyo.net/api/v1/applications/111540000000000000/guilds/111500000000000000/commands" \
  -H "Authorization: Bot $BOT_TOKEN"

Örnek yanıt

200 Başarılı

JSON

[
  {
    "id": "111560000000000000",
    "application_id": "111540000000000000",
    "version": "111560000000000001",
    "guild_id": "111500000000000000",
    "type": 1,
    "name": "selam",
    "name_localizations": {
      "en": "hello"
    },
    "description": "Birini selamlar",
    "description_localizations": {
      "en": "Greets someone"
    },
    "options": [
      {
        "type": 6,
        "name": "kisi",
        "name_localizations": {
          "en": "person"
        },
        "description": "Selamlanacak kişi",
        "description_localizations": {
          "en": "The person to greet"
        },
        "required": true
      }
    ],
    "default_member_permissions": null,
    "contexts": [
      0,
      1
    ]
  }
]

Hatalar

Durum	Kodlar
401	unauthorized
403	missing_access temporarily_banned
404	unknown_application
429	rate_limited
503	maintenance

Sunucu komutlarının hepsini değiştir

PUT/applications/{application_id}/guilds/{guild_id}/commands

Listeyi bu sunucunun komutlarının tamamı yapar, tek adımda. Türü ve adı eşleşen komutun kimliği kalır; listede olmayanlar silinir; boş liste hepsini siler. Bir tanım geçersizse hiçbir şey değişmez. Günlük sınıra yalnız yeni komutlar sayılır; bunu bot açılırken gönder. Botun bir sunucuya özel komutları. Bot o sunucuda üye olmalı; değilse yanıt missing_access olur.

Kimlik: Bot token'ı (bir kişinin oturumu da olur)
Hız sınırı: command 5 istek / 20 sn

Parametreler

Ad	Tür	Açıklama
`application_id`zorunlu	string	Adreste Uygulama ID'si.
`guild_id`zorunlu	string	Adreste Sunucu ID'si.

Örnek istek

curl -X PUT "https://noluyo.net/api/v1/applications/111540000000000000/guilds/111500000000000000/commands" \
  -H "Authorization: Bot $BOT_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '[{"name":"selam","description":"Birini selamlar","options":[{"type":6,"name":"kisi","description":"Selamlanacak kişi","required":true}]},{"type":2,"name":"Profili aç"}]'

Örnek gövde

application/json

[
  {
    "name": "selam",
    "name_localizations": {
      "en": "hello"
    },
    "description": "Birini selamlar",
    "description_localizations": {
      "en": "Greets someone"
    },
    "options": [
      {
        "type": 6,
        "name": "kisi",
        "name_localizations": {
          "en": "person"
        },
        "description": "Selamlanacak kişi",
        "description_localizations": {
          "en": "The person to greet"
        },
        "required": true
      }
    ]
  },
  {
    "type": 2,
    "name": "Profili aç"
  }
]

Örnek yanıt

200 Başarılı

JSON

[
  {
    "id": "111560000000000000",
    "application_id": "111540000000000000",
    "version": "111560000000000001",
    "guild_id": "111500000000000000",
    "type": 1,
    "name": "selam",
    "name_localizations": {
      "en": "hello"
    },
    "description": "Birini selamlar",
    "description_localizations": {
      "en": "Greets someone"
    },
    "options": [
      {
        "type": 6,
        "name": "kisi",
        "name_localizations": {
          "en": "person"
        },
        "description": "Selamlanacak kişi",
        "description_localizations": {
          "en": "The person to greet"
        },
        "required": true
      }
    ],
    "default_member_permissions": null,
    "contexts": [
      0,
      1
    ]
  }
]

Hatalar

Durum	Kodlar
400	validation_failed invalid_body max_commands
401	unauthorized
403	missing_access temporarily_banned
404	unknown_application
413	body_too_large
429	rate_limited
503	maintenance

Sunucu komutu oluştur

POST/applications/{application_id}/guilds/{guild_id}/commands

Komut ekler. Aynı tür ve adda komut varsa tanımı değişir, kimliği kalır: 201 yerine 200 döner. Yeni komut, kapsam başına günde 200 yeni komuta sayılır; güncelleme sayılmaz. Kişiler değişikliği en geç 60 saniyede görür. Botun bir sunucuya özel komutları. Bot o sunucuda üye olmalı; değilse yanıt missing_access olur.

Kimlik: Bot token'ı (bir kişinin oturumu da olur)
Hız sınırı: command 5 istek / 20 sn

Parametreler

Ad	Tür	Açıklama
`application_id`zorunlu	string	Adreste Uygulama ID'si.
`guild_id`zorunlu	string	Adreste Sunucu ID'si.

Gövde alanları

Ad	Tür	Açıklama
`type`	integer	1 eğik çizgi komutu (varsayılan), 2 kullanıcı menüsü, 3 mesaj menüsü. 1, 2, 3
`name`zorunlu	string	Eğik çizgi komutu: küçük harf, rakam, - ve _. Menü: en çok 32 karakter, boşluk ve büyük harf olabilir. 1–32
`name_localizations`	object	Adın tr ve en karşılığı.
`description`	string	Eğik çizgi komutunda zorunlu, menüde boş. ≤ 100
`description_localizations`	object	Açıklamanın tr ve en karşılığı.
`options`	CommandOption[]	Yalnız eğik çizgi komutunda. ≤ 25
`default_member_permissions`	permissions \| null	Sunucu kural koyana dek kimin kullanacağı: null herkes, "0" yalnız sahip ve yöneticiler, değilse bu bitlerin hepsine sahip üyeler.
`contexts`	integer[]	Nerede çalıştığı: 0 sunucu kanalı, 1 kişinin botunla açtığı DM. Gönderilmezse [0, 1]. Her biri en çok bir kez. `default_member_permissions` dolu komut bu ne derse desin DM'de çalışmaz: orada kimsenin izin biti yok. 1–2

Örnek istek

curl -X POST "https://noluyo.net/api/v1/applications/111540000000000000/guilds/111500000000000000/commands" \
  -H "Authorization: Bot $BOT_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"name":"selam","description":"Birini selamlar","options":[{"type":6,"name":"kisi","description":"Selamlanacak kişi","required":true}]}'

Örnek gövde

application/json

{
  "name": "selam",
  "name_localizations": {
    "en": "hello"
  },
  "description": "Birini selamlar",
  "description_localizations": {
    "en": "Greets someone"
  },
  "options": [
    {
      "type": 6,
      "name": "kisi",
      "name_localizations": {
        "en": "person"
      },
      "description": "Selamlanacak kişi",
      "description_localizations": {
        "en": "The person to greet"
      },
      "required": true
    }
  ]
}

Örnek yanıt

200 Başarılı

JSON

{
  "id": "111560000000000000",
  "application_id": "111540000000000000",
  "version": "111560000000000001",
  "guild_id": "111500000000000000",
  "type": 1,
  "name": "selam",
  "name_localizations": {
    "en": "hello"
  },
  "description": "Birini selamlar",
  "description_localizations": {
    "en": "Greets someone"
  },
  "options": [
    {
      "type": 6,
      "name": "kisi",
      "name_localizations": {
        "en": "person"
      },
      "description": "Selamlanacak kişi",
      "description_localizations": {
        "en": "The person to greet"
      },
      "required": true
    }
  ],
  "default_member_permissions": null,
  "contexts": [
    0,
    1
  ]
}

Hatalar

Durum	Kodlar
400	validation_failed invalid_body max_commands
401	unauthorized
403	missing_access temporarily_banned
404	unknown_application
413	body_too_large
429	rate_limited
503	maintenance

Sunucu komutunu getir

GET/applications/{application_id}/guilds/{guild_id}/commands/{command_id}

Bu sunucunun komutlarından birini döner. Botun bir sunucuya özel komutları. Bot o sunucuda üye olmalı; değilse yanıt missing_access olur.

Kimlik: Bot token'ı (bir kişinin oturumu da olur)
Hız sınırı: read 30 istek / 5 sn

Parametreler

Ad	Tür	Açıklama
`application_id`zorunlu	string	Adreste Uygulama ID'si.
`guild_id`zorunlu	string	Adreste Sunucu ID'si.
`command_id`zorunlu	string	Adreste Komut ID'si.

Örnek istek

curl -X GET "https://noluyo.net/api/v1/applications/111540000000000000/guilds/111500000000000000/commands/111560000000000000" \
  -H "Authorization: Bot $BOT_TOKEN"

Örnek yanıt

200 Başarılı

JSON

{
  "id": "111560000000000000",
  "application_id": "111540000000000000",
  "version": "111560000000000001",
  "guild_id": "111500000000000000",
  "type": 1,
  "name": "selam",
  "name_localizations": {
    "en": "hello"
  },
  "description": "Birini selamlar",
  "description_localizations": {
    "en": "Greets someone"
  },
  "options": [
    {
      "type": 6,
      "name": "kisi",
      "name_localizations": {
        "en": "person"
      },
      "description": "Selamlanacak kişi",
      "description_localizations": {
        "en": "The person to greet"
      },
      "required": true
    }
  ],
  "default_member_permissions": null,
  "contexts": [
    0,
    1
  ]
}

Hatalar

Durum	Kodlar
401	unauthorized
403	missing_access temporarily_banned
404	unknown_application unknown_command
429	rate_limited
503	maintenance

Sunucu komutunu düzenle

PATCH/applications/{application_id}/guilds/{guild_id}/commands/{command_id}

Gönderilen alanları değiştirir, diğerleri kalır. type değişmez: komutu silip yeniden oluştur. version değişir. Botun bir sunucuya özel komutları. Bot o sunucuda üye olmalı; değilse yanıt missing_access olur.

Kimlik: Bot token'ı (bir kişinin oturumu da olur)
Hız sınırı: command 5 istek / 20 sn

Parametreler

Ad	Tür	Açıklama
`application_id`zorunlu	string	Adreste Uygulama ID'si.
`guild_id`zorunlu	string	Adreste Sunucu ID'si.
`command_id`zorunlu	string	Adreste Komut ID'si.

Gövde alanları

Ad	Tür	Açıklama
`type`	integer	1 eğik çizgi komutu (varsayılan), 2 kullanıcı menüsü, 3 mesaj menüsü. 1, 2, 3
`name`zorunlu	string	Eğik çizgi komutu: küçük harf, rakam, - ve _. Menü: en çok 32 karakter, boşluk ve büyük harf olabilir. 1–32
`name_localizations`	object	Adın tr ve en karşılığı.
`description`	string	Eğik çizgi komutunda zorunlu, menüde boş. ≤ 100
`description_localizations`	object	Açıklamanın tr ve en karşılığı.
`options`	CommandOption[]	Yalnız eğik çizgi komutunda. ≤ 25
`default_member_permissions`	permissions \| null	Sunucu kural koyana dek kimin kullanacağı: null herkes, "0" yalnız sahip ve yöneticiler, değilse bu bitlerin hepsine sahip üyeler.
`contexts`	integer[]	Nerede çalıştığı: 0 sunucu kanalı, 1 kişinin botunla açtığı DM. Gönderilmezse [0, 1]. Her biri en çok bir kez. `default_member_permissions` dolu komut bu ne derse desin DM'de çalışmaz: orada kimsenin izin biti yok. 1–2

Örnek istek

curl -X PATCH "https://noluyo.net/api/v1/applications/111540000000000000/guilds/111500000000000000/commands/111560000000000000" \
  -H "Authorization: Bot $BOT_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"description":"Birine merhaba der"}'

Örnek gövde

application/json

{
  "description": "Birine merhaba der"
}

Örnek yanıt

200 Başarılı

JSON

{
  "id": "111560000000000000",
  "application_id": "111540000000000000",
  "version": "111560000000000001",
  "guild_id": "111500000000000000",
  "type": 1,
  "name": "selam",
  "name_localizations": {
    "en": "hello"
  },
  "description": "Birini selamlar",
  "description_localizations": {
    "en": "Greets someone"
  },
  "options": [
    {
      "type": 6,
      "name": "kisi",
      "name_localizations": {
        "en": "person"
      },
      "description": "Selamlanacak kişi",
      "description_localizations": {
        "en": "The person to greet"
      },
      "required": true
    }
  ],
  "default_member_permissions": null,
  "contexts": [
    0,
    1
  ]
}

Hatalar

Durum	Kodlar
400	validation_failed invalid_body
401	unauthorized
403	missing_access temporarily_banned
404	unknown_application unknown_command
413	body_too_large
429	rate_limited
503	maintenance

Sunucu komutunu sil

DELETE/applications/{application_id}/guilds/{guild_id}/commands/{command_id}

Bu sunucunun komutlarından birini izin kurallarıyla siler. Botun bir sunucuya özel komutları. Bot o sunucuda üye olmalı; değilse yanıt missing_access olur.

Kimlik: Bot token'ı (bir kişinin oturumu da olur)
Hız sınırı: command 5 istek / 20 sn

Parametreler

Ad	Tür	Açıklama
`application_id`zorunlu	string	Adreste Uygulama ID'si.
`guild_id`zorunlu	string	Adreste Sunucu ID'si.
`command_id`zorunlu	string	Adreste Komut ID'si.

Örnek istek

curl -X DELETE "https://noluyo.net/api/v1/applications/111540000000000000/guilds/111500000000000000/commands/111560000000000000" \
  -H "Authorization: Bot $BOT_TOKEN"

Örnek yanıt

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

Hatalar

Durum	Kodlar
401	unauthorized
403	missing_access temporarily_banned
404	unknown_application unknown_command
429	rate_limited
503	maintenance

Sunucudaki komut kurallarını listele

GET/applications/{application_id}/guilds/{guild_id}/commands/permissions

Bu botun komutları için bir sunucuda konmuş her kural: kuralı olan her komut için bir kayıt, tüm komutlarının kuralları için uygulamanın ID'siyle bir kayıt. Kuralı olmayan komut listede yer almaz. Bot o sunucuda üye olmalı; değilse yanıt missing_access olur. Kuralları yalnızca sunucu yöneticileri N'oluyo'da yazar; bot okur ve değişince APPLICATION_COMMAND_PERMISSIONS_UPDATE alır. Sunucu kuralları zaten uygular: kişinin kullanamayacağı komut ona gösterilmez ve çalışmaz.

Kimlik: Bot token'ı (bir kişinin oturumu da olur)
Hız sınırı: read 30 istek / 5 sn

Parametreler

Ad	Tür	Açıklama
`application_id`zorunlu	string	Adreste Uygulama ID'si.
`guild_id`zorunlu	string	Adreste Sunucu ID'si.

Örnek istek

curl -X GET "https://noluyo.net/api/v1/applications/111540000000000000/guilds/111500000000000000/commands/permissions" \
  -H "Authorization: Bot $BOT_TOKEN"

Örnek yanıt

200 Başarılı

JSON

[
  {
    "id": "111540000000000000",
    "application_id": "111540000000000000",
    "guild_id": "111500000000000000",
    "permissions": [
      {
        "type": 1,
        "id": "111500000000000000",
        "allow": false
      }
    ]
  },
  {
    "id": "111560000000000000",
    "application_id": "111540000000000000",
    "guild_id": "111500000000000000",
    "permissions": [
      {
        "type": 1,
        "id": "111520000000000000",
        "allow": true
      },
      {
        "type": 3,
        "id": "0",
        "allow": false
      },
      {
        "type": 3,
        "id": "111510000000000000",
        "allow": true
      }
    ]
  }
]

Hatalar

Durum	Kodlar
401	unauthorized
403	missing_access temporarily_banned
404	unknown_application
429	rate_limited
503	maintenance

Komutun kurallarını getir

GET/applications/{application_id}/guilds/{guild_id}/commands/{command_id}/permissions

Bir komutun bir sunucudaki kuralları: global komut ya da bu sunucunun komutu. Kural yoksa liste boştur. Tüm komutların kuralları (uygulamanın ID'siyle olan kayıt) burada yer almaz; onları yukarıdaki rotayla listele. Bot o sunucuda üye olmalı; değilse yanıt missing_access olur. Kuralları yalnızca sunucu yöneticileri N'oluyo'da yazar; bot okur ve değişince APPLICATION_COMMAND_PERMISSIONS_UPDATE alır. Sunucu kuralları zaten uygular: kişinin kullanamayacağı komut ona gösterilmez ve çalışmaz.

Kimlik: Bot token'ı (bir kişinin oturumu da olur)
Hız sınırı: read 30 istek / 5 sn

Parametreler

Ad	Tür	Açıklama
`application_id`zorunlu	string	Adreste Uygulama ID'si.
`guild_id`zorunlu	string	Adreste Sunucu ID'si.

Örnek istek

curl -X GET "https://noluyo.net/api/v1/applications/111540000000000000/guilds/111500000000000000/commands/111560000000000000/permissions" \
  -H "Authorization: Bot $BOT_TOKEN"

Örnek yanıt

200 Başarılı

JSON

{
  "id": "111560000000000000",
  "application_id": "111540000000000000",
  "guild_id": "111500000000000000",
  "permissions": [
    {
      "type": 1,
      "id": "111520000000000000",
      "allow": true
    },
    {
      "type": 3,
      "id": "0",
      "allow": false
    },
    {
      "type": 3,
      "id": "111510000000000000",
      "allow": true
    }
  ]
}

Hatalar

Durum	Kodlar
401	unauthorized
403	missing_access temporarily_banned
404	unknown_application unknown_command
429	rate_limited
503	maintenance