> ## 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 Referansı

> GOWA REST API için temel URL, kimlik doğrulama, cihaz seçimi, istek biçimleri ve yanıt zarfı.

## Temel URL

```text theme={null}
http://<host>:3000<APP_BASE_PATH>
```

Varsayılan değer `http://localhost:3000` adresidir. `APP_BASE_PATH=/gowa` ayarlandığında `/health` dışındaki tüm yollar `/gowa` altına taşınır.

## Kimlik doğrulama

`APP_BASIC_AUTH` ayarlandığında `/health`, `/statics/*`, Chatwoot webhook'u ve MCP OAuth uç noktaları dışındaki her yol HTTP Basic Auth gerektirir. Bkz. [Kimlik doğrulama](https://gowa-docs.mintlify.site/tr/api-reference/authentication.md).

## Cihaz seçimi

Çoğu yol tek bir WhatsApp cihazında işlem yapar. Cihazı `X-Device-Id` üst bilgisiyle (yuva kimliği veya JID) ya da `device_id` sorgu parametresiyle seçin. Sunucuda tam olarak bir cihaz varsa bunu atlayabilirsiniz; birden fazla cihaz olduğunda zorunludur.

| Cihaz kapsamında | Cihaz kapsamında değil |
| - | - |
| `/app/*` (`/app/info` ve `/app/metrics` hariç), `/send/*`, `/message/*`, `/chat/*`, `/chats`, `/user/*`, `/group/*`, `/newsletter/*`, `/call/*` | `/devices*`, `/app/info`, `/app/metrics`, `/health`, `/mcp`, `/chatwoot/*` |

Bkz. [Çoklu cihaz](https://gowa-docs.mintlify.site/tr/concepts/multidevice.md).

## Uç nokta grupları

| Grup | Amaç |
| - | - |
| Cihazlar | Cihaz yuvaları oluşturma, listeleme, oturum açma, oturum kapatma ve silme; cihaz başına webhook'lar ve Chatwoot yapılandırmaları. |
| Uygulama | Oturum açma (QR, eşleştirme kodu, geçiş anahtarı), oturum kapatma, yeniden bağlanma, durum, sunucu bilgisi ve süreç, bellek, disk ve cihaz metrikleri. |
| Gönderim | Metin, medya, kişi, konum, bağlantı, anket, çevrimiçi durum; zamanlama; anında deneysel etkileşimli gönderimler. |
| Mesaj | Tepki verme, düzenleme, geri alma, silme, okuma, yıldızlama, iletme, medya indirme. |
| Sohbet | Sohbetleri ve mesajları listeleme; sabitleme, arşivleme, kaybolma zamanlayıcısı, geçmiş isteği. |
| Kullanıcı | Profil bilgisi, avatar, görünen ad, gizlilik, kişiler, gruplar, numara kontrolü. |
| Grup | Oluşturma, katılımcılar, yöneticiler, katılma istekleri, ayarlar, davet bağlantıları. |
| Bülten | Takip etme, takibi bırakma, kanal bilgisi, dizin, mesajlar, sayaçlar, canlı güncellemeler ve medya indirme. |
| Arama | Gelen aramaları reddetme. |

Bu sekmedeki uç nokta sayfaları, GOWA'nın OpenAPI tanımından üretilir. Yetkili sözleşme, sunucu deposundaki [`docs/openapi.yaml`](https://github.com/aldinokemal/go-whatsapp-web-multidevice/blob/main/docs/openapi.yaml) dosyasıdır. Bu site, `/send/interactive` dahil olmak üzere `openapi.yml` içinde eşitlenmiş bir kopya kullanır. [Etkileşimli mesajlar kılavuzu](https://gowa-docs.mintlify.site/tr/examples/interactive-messages.md) güncel sınırları açıklar.

## İstekler

* JSON gövdeleri: `Content-Type: application/json`.
* Dosya yüklemeleri: `multipart/form-data`.
* Telefon numaraları: ülke koduyla birlikte rakamlar (`628123456789`) veya tam JID (`...@s.whatsapp.net`, `...@g.us`).

## Yanıtlar

```json theme={null}
{
  "code": "SUCCESS",
  "message": "Success",
  "results": {}
}
```

`code`, `SUCCESS` veya bir hata kodudur; `results` verileri içerir. Bkz. [Hatalar](https://gowa-docs.mintlify.site/tr/api-reference/errors.md).

## Örnek

```bash theme={null}
curl -u admin:changeme -X POST http://localhost:3000/send/message \
  -H "Content-Type: application/json" \
  -H "X-Device-Id: my-device" \
  -d '{"phone": "628123456789", "message": "Hello from GOWA"}'
```

## Kişi adları

`GET /user/my/contacts`, her kişi için tercih edilen bir görünen ad döndürür. v9.9.0 sonrasındaki GOWA `main` dalında, kayıtlı `full_name`, `first_name`, `push_name` ve `business_name` değerlerini ayrı alanlar olarak almak için `GET /user/my/contacts/detailed` çağrısını yapın. GOWA boş adları atlar ve cihazda bir eşleme varsa telefon numarası JID'sine `lid` ekler. Sonuçlar, seçili cihazdaki kişileri `jid` sırasına göre içerir.

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

## Diğer arayüzler

* Canlı panel olayları için `/ws` adresinde **[WebSocket](https://gowa-docs.mintlify.site/tr/api-reference/websocket.md)**.
* Yapay zeka ajanları için `/mcp` adresinde **MCP** ([MCP sunucusu](https://gowa-docs.mintlify.site/tr/integrations/mcp.md)).
* URL'lerinize gönderilen **Webhook'lar** ([Webhook'lar](https://gowa-docs.mintlify.site/tr/concepts/webhooks.md)).


## Related topics

- [API Kimlik Doğrulaması](https://gowa-docs.mintlify.site/tr/api-reference/authentication.md)
- [Hatalar](https://gowa-docs.mintlify.site/tr/api-reference/errors.md)
- [Python](https://gowa-docs.mintlify.site/tr/api-reference/sdks/python.md)
- [Go](https://gowa-docs.mintlify.site/tr/api-reference/sdks/go.md)
- [Hız Sınırları](https://gowa-docs.mintlify.site/tr/api-reference/rate-limits.md)


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