Ana içeriğe atla

Temel URL

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.

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 /ws adresinde WebSocket.
  • Yapay zeka ajanları için /mcp adresinde MCP (MCP sunucusu).
  • URL’lerinize gönderilen Webhook’lar (Webhook’lar).