グリーンランド向けSMS API: +299番号への一括SMS

グリーンランドは、世界最大の島で、デンマーク王国の自治領であり、その北極環境と漁業で知られています。旅行代理店、海運会社、政府サービスなどの組織は、ユーザーにテキストメッセージを送信します。これらのメッセージは、フライトの更新、貨物の到着、公共サービスの発表などのイベントによってトリガーされます。SMSは、遠隔地でも信頼性が高く、すべてのモバイルデバイスで動作し、迅速に読まれるため、住民と訪問者の両方に理想的です。

APIキーを取得グリーンランドへのリクエスト

グリーンランド

国番号 +299

SMSセグメントごと: $0.00587
$100分のメッセージ数: 17,035
現地言語: デンマーク語
エンコーディング: GSM-7

グリーンランドへの一括SMS送信の費用

グリーンランドへのメッセージは1セグメントあたり$0.00587で課金されます。160文字のGSM-7または70文字のUnicodeを超えるテキストはセグメントに分割されるため、2セグメントのテキストは2倍の費用がかかります。

メッセージ	1セグメント	2セグメント
1	$0.00587	$0.01174
1,000	$5.87	$11.74
10,000	$58.70	$117.40
100,000	$587.00	$1,174.00

グリーンランドの番号形式

グリーンランドの携帯電話番号は、+299の後に6桁の数字があり、トランクプレフィックスはありません。そのため、ローカル形式の22 12 34は、toフィールドで+299 22 12 34になります。

アルファベットとセグメント

デンマーク語のテキストはGSM-7アルファベット内に収まるため、グリーンランド向けの1セグメントは160文字、長文の各部分は153文字までです。他のツールからコピーした曲がった引用符や絵文字に注意してください。1つでも含まれるとUnicodeに移行し、1セグメントあたり70文字になります。POST /v1/estimatesで送信前にエンコーディングを確認できます。

タイムゾーンとタイミング

グリーンランドは複数のタイムゾーンにまたがっており、1月の時差はチューレのUTC-4からダンマークスハウンのUTC+0までです。UTCで11:00にsend_atを設定すると、1月のヌークでは09:00に配信されます。全国向けのリマインダーは、地域ごとにリストを分割し、各バッチに独自のsend_atを設定してください。

1リクエストでグリーンランドに送信

応答にはメッセージID、番号が一致した国（GL）、および価格が即座に返されます。配信または失敗イベントがウェブフックに続き、失敗したメッセージは返金されます。

リストの場合は、POST /v1/batchesを使用して同じテキストを最大10,000番号に送信するか、messages内で番号ごとに個別のテキストを送信します。

メッセージリファレンスバッチリファレンス

curl https://bulksmsapi.cc/v1/messages \
  -H "Authorization: Bearer $BULKSMSAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"to": "+299221234", "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: "+299221234", text: "Your Northwind code is 482913. It expires in 10 minutes." }),
});
console.log(await res.json()); // price: "0.00587", country: "GL"

import json, os, urllib.request

req = urllib.request.Request(
    "https://bulksmsapi.cc/v1/messages",
    data=json.dumps({"to": "+299221234", "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.00587"