> ## Documentation Index
> Fetch the complete documentation index at: https://gowa-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# API Kimlik Doğrulaması

> GOWA, API çağrılarının kimliğini yalnızca HTTP Basic Auth ile doğrular.

GOWA yalnızca **HTTP Basic Auth** destekler: REST API için API anahtarları, bearer token'ları veya JWT'ler yoktur. (MCP ayrıca OAuth token'larını kabul edebilir; bkz. [MCP sunucusu](https://gowa-docs.mintlify.site/tr/integrations/mcp.md#oauth-kullanan-uzak-istemciler).)

## Yapılandırma

```bash theme={null}
APP_BASIC_AUTH=admin:changeme,ops:another-password   # or --basic-auth=admin:changeme
```

Virgülle ayrılmış her `user:pass` çifti geçerli bir oturum açma bilgisidir. Her girdide hem kullanıcı adı hem de parola bulunmalıdır. Loopback dışındaki bir adreste dinleyen sunucu, eksiksiz kimlik bilgileri olmadan başlamayı reddeder. Kimlik doğrulaması olmadan yerel geliştirme için `APP_HOST=127.0.0.1` adresine bağlayın. `APP_ALLOW_UNAUTHENTICATED=true` ayarını yalnızca ters proxy çağrıları yapanların kimliğini doğruladığında ve GOWA'ya doğrudan erişim kısıtlandığında kullanın.

## Kimlik bilgilerini gönderme

```bash curl theme={null}
curl -u admin:changeme -H "X-Device-Id: my-device" \
  http://localhost:3000/app/devices
```

```bash Header theme={null}
curl -H "Authorization: Basic $(echo -n 'admin:changeme' | base64)" \
  -H "X-Device-Id: my-device" \
  http://localhost:3000/app/devices
```

```javascript JavaScript theme={null}
const res = await fetch("http://localhost:3000/user/my/groups", {
  headers: {
    Authorization: "Basic " + Buffer.from("admin:changeme").toString("base64"),
    "X-Device-Id": "my-device",
  },
});
```

```python Python theme={null}
import requests
r = requests.get("http://localhost:3000/user/my/groups",
                 auth=("admin", "changeme"),
                 headers={"X-Device-Id": "my-device"})
```

Yanlış veya eksik kimlik bilgileri `401 Unauthorized` döndürür.

## Herkese açık yollar

| Yol | Nedeni |
| - | - |
| `/health` | Canlılık kontrolleri. |
| `/statics/*` | QR görüntüleri ve medya dosyaları. Bilinen URL'ler herkese açık kalır. Görüntü dışındaki yüklemeler ek olarak indirilir. Gerekirse proxy'nizde erişimi koruyun. |
| `/chatwoot/webhook`, `/chatwoot/webhook/{device_id}` | Chatwoot tarafından çağrılır; `CHATWOOT_WEBHOOK_SECRET` ile korunur. |
| MCP OAuth uç noktaları ve `/.well-known/*` meta verileri | Etkinleştirildiğinde OAuth akışı. |

## WebSocket

Tarayıcılar WebSocket bağlantılarında üst bilgi ayarlayamadığından `/ws`, `/ws?device_id=my-device&authorization=<base64 user:pass>` biçimini de kabul eder. `wss://` kullanın ve proxy günlüklerindeki kimlik bilgilerini gizleyin.

WebSocket ve durumu değiştiren HTTP yolları, güvenilmeyen tarayıcı origin'lerini reddeder. Panelin tam origin değerini `APP_TRUSTED_ORIGINS` veya `APP_CORS_ALLOWED_ORIGINS` içinde ayarlayın. Joker karakterli bir CORS origin'i bu erişimi sağlamaz ve `file://` sayfalarından gelen `null` origin'ler reddedilir. Güvenilmeyen bir origin'den gelen HTTP değişiklik istekleri `403 CROSS_SITE_REQUEST_BLOCKED` döndürür. Bkz. [tarayıcı erişimi yapılandırması](https://gowa-docs.mintlify.site/tr/authentication.md#cors).

## Cihaz üst bilgisi

Basic Auth, WhatsApp hesabını değil API çağrısını yapanı tanımlar. Birden fazla cihaz olduğunda cihaz kapsamındaki her çağrı ayrıca `X-Device-Id` gerektirir. Bkz. [Çoklu cihaz](https://gowa-docs.mintlify.site/tr/concepts/multidevice.md).

> [!WARNING]
>
> Basic Auth her istekte kimlik bilgilerini gönderir. Güvenilir bir ağın dışında GOWA'nın önünde her zaman HTTPS kullanın.


## Related topics

- [Kimlik doğrulama](https://gowa-docs.mintlify.site/tr/authentication.md)
- [API Referansı](https://gowa-docs.mintlify.site/tr/api-reference/introduction.md)
- [Hızlı başlangıç](https://gowa-docs.mintlify.site/tr/quickstart.md)
- [GOWA: WhatsApp REST API](https://gowa-docs.mintlify.site/tr/index.md)
- [Sunucu metrikleri](https://gowa-docs.mintlify.site/tr/api-reference/metrics.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.