توثيق API

curl -X GET https://waslapi.com/api/v1/instances \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

$response = Http::withToken('YOUR_API_TOKEN')
    ->get('https://waslapi.com/api/v1/instances');

$instances = $response->json();

curl -X POST https://waslapi.com/api/v1/instances \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "رقم المتجر", "proxy_country": "sa"}'

{
  "success": false,
  "error": "NO_CAPACITY",
  "message": "No server capacity available. Please contact support."
}

curl -X GET https://waslapi.com/api/v1/proxy/countries \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

{
  "success": true,
  "data": [
    {
      "code": "sa",
      "name_ar": "السعودية",
      "name_en": "Saudi Arabia"
    },
    {
      "code": "ae",
      "name_ar": "الإمارات",
      "name_en": "United Arab Emirates"
    }
  ]
}

curl -X GET https://waslapi.com/api/v1/instances/1/qr \
  -H "Authorization: Bearer YOUR_API_TOKEN"

curl -X GET https://waslapi.com/api/v1/instances/1 \
  -H "Authorization: Bearer YOUR_API_TOKEN"

{
  "success": true,
  "data": {
    "id": 1,
    "instance_name": "1_my_store",
    "status": "connected",
    "phone_number": "966501234567",
    "proxy_country": "sa",
    "connected_at": "2026-03-01T10:00:00.000000Z",
    "created_at": "2026-02-28T08:00:00.000000Z"
  }
}

curl -X POST https://waslapi.com/api/v1/messages/send-text \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "instance_id": 1,
    "to": "966501234567",
    "message": "مرحباً! هذه رسالة تجريبية."
  }'

import requests

url = "https://waslapi.com/api/v1/messages/send-text"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "instance_id": 1,
    "to": "966501234567",
    "message": "مرحباً من Python!"
}

response = requests.post(url, json=data, headers=headers)
print(response.json())

const response = await fetch('https://waslapi.com/api/v1/messages/send-text', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    instance_id: 1,
    to: '966501234567',
    message: 'مرحباً من Node.js!'
  })
});

const data = await response.json();
console.log(data);

curl -X POST https://waslapi.com/api/v1/messages/send-media \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "instance_id": 1,
    "to": "966501234567",
    "media_type": "image",
    "media_url": "https://example.com/photo.jpg",
    "caption": "صورة المنتج"
  }'

curl -X GET https://waslapi.com/api/v1/contacts?classification=safe \
  -H "Authorization: Bearer YOUR_API_TOKEN"

{
  "success": true,
  "data": {
    "total": 150,
    "safe": 95,
    "caution": 30,
    "new": 25,
    "blocked": 3
  }
}

curl -X POST https://waslapi.com/api/v1/contacts \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"phone_number":"966500000000","name":"أحمد","instance_id":1}'

curl -X PUT https://waslapi.com/api/v1/contacts/1 \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"أحمد محمد","classification":"safe"}'

curl -X POST https://waslapi.com/api/v1/contacts/1/block \
  -H "Authorization: Bearer YOUR_API_TOKEN"

curl -X DELETE https://waslapi.com/api/v1/contacts/1 \
  -H "Authorization: Bearer YOUR_API_TOKEN"

curl -X POST https://waslapi.com/api/v1/contacts/transfer \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"source_instance_id": 1, "target_instance_id": 2}'

curl -X POST https://waslapi.com/api/v1/contacts/import \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -F "contacts_file=@contacts.vcf" \
  -F "instance_id=1"

curl -X GET https://waslapi.com/api/v1/contacts/export/csv?classification=safe \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -o contacts.csv

curl -X POST https://waslapi.com/api/v1/broadcasts \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "حملة العيد",
    "instance_id": 1,
    "message_content": "كل عام وأنتم بخير! 🎉",
    "target_classification": "safe",
    "rate_limit_seconds": 5
  }'

curl -X POST https://waslapi.com/api/v1/broadcasts \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "حملة مجدولة",
    "instance_id": 1,
    "message_content": "رسالة مجدولة",
    "target_classification": "safe",
    "rate_limit_seconds": 5,
    "scheduled_at": "2026-03-01T10:00:00"
  }'

curl -X POST https://waslapi.com/api/v1/broadcasts \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -F "name=حملة بصورة" \
  -F "instance_id=1" \
  -F "message_content=مرحباً! شاهد عرضنا الجديد" \
  -F "target_classification=safe" \
  -F "rate_limit_seconds=5" \
  -F "broadcast_image=@/path/to/image.png"

curl -X GET https://waslapi.com/api/v1/broadcasts \
  -H "Authorization: Bearer YOUR_API_TOKEN"

curl -X GET https://waslapi.com/api/v1/broadcasts/1 \
  -H "Authorization: Bearer YOUR_API_TOKEN"

curl -X POST https://waslapi.com/api/v1/broadcasts/1/cancel \
  -H "Authorization: Bearer YOUR_API_TOKEN"

curl -X POST https://waslapi.com/api/v1/webhooks/setup \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"webhook_url":"https://example.com/webhook","webhook_secret":"my_secret"}'

curl -X GET https://waslapi.com/api/v1/webhooks/config \
  -H "Authorization: Bearer YOUR_API_TOKEN"

{
  "success": true,
  "data": {
    "webhook_url": "https://example.com/webhook",
    "has_secret": true
  }
}

curl -X GET https://waslapi.com/api/v1/usage \
  -H "Authorization: Bearer YOUR_API_TOKEN"

{
  "plan": "احترافي",
  "messages_used": 1250,
  "messages_limit": 10000,
  "messages_remaining": 8750,
  "bandwidth_used_mb": 45.2,
  "bandwidth_limit_mb": 500,
  "instances_count": 3,
  "instances_limit": 5,
  "contacts_count": 150,
  "contacts_limit": 10000,
  "allows_broadcast": true,
  "allows_scheduling": true,
  "expires_at": "2026-04-15"
}