شروع سریع

curl -X POST "https://sms.najva.com/v2/sms/send" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "sender": "3000505",
        "receivers": ["09121234567"],
        "message": "سلام! این نخستین پیامک ما با API نجواست."
      }'

{
  "return": { "status": 200, "message": "درخواست تایید شد." },
  "entries": [
    {
      "messageid": 18392011,
      "message": "سلام! این نخستین پیامک ما با API نجواست.\nلغو۱۱",
      "status": 1,
      "statustext": "در صف ارسال",
      "sender": "3000505",
      "receptor": "09121234567",
      "date": 1757145600,
      "cost": 700
    }
  ]
}

curl -X POST "https://sms.najva.com/v2/sms/status" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"messageids": [18392011]}'

{
  "return": { "status": 200, "message": "درخواست تایید شد." },
  "entries": [
    { "messageid": 18392011, "status": 10, "statustext": "رسیده به گیرنده" }
  ]
}

import requests
BASE_URL = "https://sms.najva.com"
API_KEY = "YOUR_API_KEY"
response = requests.post(
    f"{BASE_URL}/v2/sms/send",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "sender": "3000505",
        "receivers": ["09121234567"],
        "message": "سلام!",
    },
)
body = response.json()
result = body["return"]
if result["status"] == 200:
    for item in body["entries"]:
        print(item["messageid"], item["statustext"])
else:
    print("خطا:", result["status"], result["message"])