Live

WhatsApp Primary Engine

Gerçek WhatsApp cihazı üzerinden mesaj gönderme ve alma için REST API servisi. Token tabanlı kimlik doğrulama ile güvenli erişim.

Base URL
https://wasender.aq.si
Protokol
REST / JSON
Cihaz Tipi
Primary Device
Veritabanı
MongoDB Atlas
Kontrol ediliyor...

🔐 Kimlik Doğrulama

Tüm API endpoint'leri (/health hariç) token ile korunmaktadır. Aşağıdaki yöntemlerden birini kullanın:

🔑 Desteklenen Yöntemler

HEADER X-API-Token: <your-token>
BEARER Authorization: Bearer <your-token>
QUERY ?token=<your-token>
# Geçersiz veya eksik token yanıtı
{
  "detail": "Unauthorized: Geçersiz veya eksik API Token."
}
# HTTP 401

📡 API Endpoint'leri

Tüm endpoint'lerde JSON formatında yanıt döner.

POST /api/send WhatsApp mesajı gönder

Parametreler (JSON Body)

AlanAçıklama
phone ZORUNLUHedef telefon numarası. Uluslararası formatta (+905xxxxxxxxx)
message ZORUNLUGönderilecek mesaj metni. Unicode ve emoji destekler.

Örnek İstek

curl -X POST https://wasender.aq.si/api/send \
     -H "Content-Type: application/json" \
     -H "X-API-Token: <your-token>" \
     -d '{"phone": "+905321234567", "message": "Merhaba! 👋"}'

Başarılı Yanıt

{
  "success": true,
  "phone": "905321234567",
  "message": "Merhaba! 👋",
  "status": "sent"
}

Durum Kodları

200 OK 400 Bad Request 401 Unauthorized 500 Internal Error

Denemek İster misin?


                
GET /api/messages Gelen ve giden mesaj geçmişi

Query Parametreleri

AlanAçıklama
limit OPSİYONELDöndürülecek maksimum mesaj sayısı. Varsayılan: 50

Örnek İstek

curl -H "X-API-Token: <your-token>" \
     "https://wasender.aq.si/api/messages?limit=10"

Başarılı Yanıt

{
  "messages": [
    {
      "direction": "in",
      "sender": "+905321234567",
      "recipient": "+33743939923",
      "text": "Selam!",
      "created_at": "2026-08-25T15:19:10+00:00",
      "status": "received"
    }
  ]
}
GET /api/status Motor ve cihaz durumu

Örnek İstek

curl -H "X-API-Token: <your-token>" \
     https://wasender.aq.si/api/status

Başarılı Yanıt

{
  "online": true,
  "current_app": "com.whatsapp",
  "screen_on": true,
  "phone_number": "+33743939923"
}
GET /api/chats Aktif sohbet listesi

Örnek İstek

curl -H "X-API-Token: <your-token>" \
     https://wasender.aq.si/api/chats

Başarılı Yanıt

{
  "chats": [
    { "name": "+90 532 780 60 49" }
  ]
}
GET /api/screenshot Canlı ekran görüntüsü (PNG)

Açıklama

Emülatör ekranının anlık görüntüsünü PNG formatında döner. Tarayıcıda doğrudan açılabilir.

Örnek İstek

curl -H "X-API-Token: <your-token>" \
     https://wasender.aq.si/api/screenshot -o screen.png
GET /health Sağlık kontrolü (token gerektirmez)

Açıklama

Kimlik doğrulama gerektirmez. Uptime monitoring ve load balancer health check'ler için kullanılabilir.

Başarılı Yanıt

{
  "status": "ok",
  "time": 1787672045.14
}

⚡ Notlar

Mesaj Gönderim Süresi
~1.5 saniye
Gelen Mesaj Algılama
~1 saniye (Notification Polling)
Otomatik Yeniden Başlatma
macOS LaunchAgent ile güvence altında