Temel URL
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.
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.
Bkz. Çoklu cihaz.
Uç nokta grupları
Bu sekmedeki uç nokta sayfaları, GOWA’nın OpenAPI tanımından üretilir. Yetkili sözleşme, sunucu deposundaki
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 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
code, SUCCESS veya bir hata kodudur; results verileri içerir. Bkz. Hatalar.
Örnek
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.
Diğer arayüzler
- Canlı panel olayları için
/wsadresinde WebSocket. - Yapay zeka ajanları için
/mcpadresinde MCP (MCP sunucusu). - URL’lerinize gönderilen Webhook’lar (Webhook’lar).
