# Gateway

Botların nereye ve nasıl bağlanacağı.

## Bot gateway bilgisini getir (`getGatewayBot`)

**`GET https://noluyo.net/api/v1/gateway/bot`** (`GET /gateway/bot`)

Botun nereye bağlanacağını ve kaç shard açacağını söyler. `shards`, botun bulunduğu sunucu sayısına göre önerilen sayıdır. `session_start_limit` botun o günkü oturum başlatmalarını gösterir: `total`, `remaining`, `reset_after` (günlük pencerenin sıfırlanmasına kalan milisaniye) ve `max_concurrency` (5 saniyede başlatılabilecek oturum sayısı). Okumak oturum başlatma hakkı harcamaz. Yalnızca bot token'ları.

- **Kimlik:** Bot token'ı (`Authorization: Bot <BOT_TOKEN>`)
- **Hız sınırı:** `read` (30 / 5s)

### Örnek çağrılar

```bash
curl -X GET "https://noluyo.net/api/v1/gateway/bot" \
  -H "Authorization: Bot $BOT_TOKEN"
```

```js
// JavaScript (noluyo-bot)
await bot.rest.getGatewayBot();
```

```py
# Python (noluyo_bot)
await bot.rest.get_gateway_bot()
```

### Yanıt (200)

```json
{
  "url": "wss://noluyo.net/bot-gateway",
  "shards": 1,
  "session_start_limit": {
    "total": 1000,
    "remaining": 999,
    "reset_after": 14400000,
    "max_concurrency": 1
  }
}
```

### Hata kodları

- **HTTP 401:** `unauthorized`
- **HTTP 403:** `temporarily_banned`
- **HTTP 429:** `rate_limited`
- **HTTP 503:** `maintenance`