巴勒斯坦的 SMS API：群發簡訊至 +970 號碼

巴勒斯坦位於中東，行政中心為拉馬拉，其經濟以農業、貿易和服務業為主。像是行動銀行應用程式、大學和醫療保健機構等組織會發送簡訊給使用者。這些簡訊通常是由付款確認、考試時間表和預約提醒觸發的。簡訊之所以受到青睞，是因為它能即時送達所有手機、不需要網路，並且對居民來說廣泛可用。

取得 API 金鑰巴勒斯坦的請求

巴勒斯坦

國碼 +970

每段簡訊: $0.04257
$100 可發送的簡訊數量: 2,349
本地語言: 阿拉伯語
編碼: Unicode (UCS-2)

發送至巴勒斯坦的群發簡訊費用

每則簡訊至巴勒斯坦的價格為每分段$0.04257。超過160個GSM-7字元或70個Unicode字元的內容會被分割，因此兩分段的簡訊費用將加倍。

訊息	1 個分段	2 個分段
1	$0.04257	$0.08514
1,000	$42.57	$85.14
10,000	$425.70	$851.40
100,000	$4,257.00	$8,514.00

巴勒斯坦的號碼格式

巴勒斯坦的手機號碼在 +970 之後有 9 位數字。在當地，號碼會以 0 開頭書寫（例如 0599 123 456）；但在 API 中，這個 0 會被省略，因此相同的號碼在 to 欄位中應輸入為 +970 599 123 456。

字元集與分段

阿拉伯文總是使用 Unicode，因此發送到巴勒斯坦的阿拉伯文簡訊，每段可容納 70 個字元，而較長簡訊的每一部分則可容納 67 個字元。以英文或純拉丁字母書寫的代碼和警報則可容納 160 個字元，這使得長篇通知的成本減半。

時區與發送時間

巴勒斯坦會調整時鐘：加薩在一月份使用 UTC+2，七月份則使用 UTC+3。加薩的 09:00 在一月份是 UTC 的 07:00，而在夏令時間期間則會比 UTC 早一小時。因此，請在 send_at 中提供當地偏移量（例如冬季的 +02:00），API 會自動進行轉換。

單一請求發送至巴勒斯坦

系統將立即回覆包含訊息ID、號碼所屬國家(PS)及價格。後續將透過webhook發送送達或失敗事件，失敗的訊息會自動退款。

發送清單時，可透過POST /v1/batches將相同內容發送至最多10,000組號碼，或在messages中為每組號碼指定個人化內容。

訊息參考批次參考

curl https://bulksmsapi.cc/v1/messages \
  -H "Authorization: Bearer $BULKSMSAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"to": "+970599123456", "text": "Your Northwind code is 482913. It expires in 10 minutes."}'

const res = await fetch("https://bulksmsapi.cc/v1/messages", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.BULKSMSAPI_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({ to: "+970599123456", text: "Your Northwind code is 482913. It expires in 10 minutes." }),
});
console.log(await res.json()); // price: "0.04257", country: "PS"

import json, os, urllib.request

req = urllib.request.Request(
    "https://bulksmsapi.cc/v1/messages",
    data=json.dumps({"to": "+970599123456", "text": "Your Northwind code is 482913. It expires in 10 minutes."}).encode(),
    headers={"Authorization": "Bearer " + os.environ["BULKSMSAPI_KEY"], "Content-Type": "application/json", "User-Agent": "northwind-app/1.0"},
    method="POST",
)
with urllib.request.urlopen(req) as res:
    print(json.load(res)["price"])  # "0.04257"