API Referansı | ZenWapp

API Anahtarı

Kimlik doğrulama için gerekli

# Authorization Header

Authorization: Bearer YOUR_API_KEY

API anahtarınızı panel üzerinden Ayarlar → API → Yeni Anahtar Oluştur bölümünden alabilirsiniz.

API Endpoints

POST/api/v1/messages/send

Tek bir alıcıya mesaj gönder

{
  "to": "+905551234567",
  "message": "Merhaba! ZenWapp'e hoş geldiniz.",
  "type": "text"
}

Response (200 OK):

{
  "success": true,
  "message_id": "msg_abc123",
  "status": "sent"
}

POST/api/v1/messages/bulk

Toplu mesaj gönder

{
  "recipients": [
    "+905551234567",
    "+905559876543"
  ],
  "message": "Kampanya duyurusu",
  "type": "text"
}

GET/api/v1/messages/:messageId

Mesaj durumunu sorgula

GET/api/v1/contacts

Kişi listesini getir

Webhooks

Gerçek zamanlı bildirimler almak için webhook URL'nizi ayarlayın.

message.received

Yeni mesaj geldiğinde tetiklenir

{
  "event": "message.received",
  "from": "+905551234567",
  "message": "Merhaba",
  "timestamp": "2025-10-04T12:00:00Z"
}

message.delivered

Mesaj iletildiğinde tetiklenir

message.read

Mesaj okunduğunda tetiklenir

Kod Örnekleri

Node.js

const axios = require('axios');

const sendMessage = async () => {
  const response = await axios.post(
    'https://api.zenwapp.com/v1/messages/send',
    {
      to: '+905551234567',
      message: 'Merhaba!',
      type: 'text'
    },
    {
      headers: {
        'Authorization': 'Bearer YOUR_API_KEY'
      }
    }
  );
  console.log(response.data);
};

Python

import requests

def send_message():
    response = requests.post(
        'https://api.zenwapp.com/v1/messages/send',
        json={
            'to': '+905551234567',
            'message': 'Merhaba!',
            'type': 'text'
        },
        headers={
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    )
    print(response.json())

cURL

curl -X POST https://api.zenwapp.com/v1/messages/send \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+905551234567",
    "message": "Merhaba!",
    "type": "text"
  }'

Rate Limits

Paket	İstek/Dakika	İstek/Saat
Starter	60	1,000
Professional	120	5,000
Enterprise	Sınırsız	Sınırsız

API Entegrasyonu için Yardım mı Lazım?

Geliştirici destek ekibimiz size yardımcı olmaya hazır

API Desteği Al