基本的な送信(個別)
リクエスト例
curl -X POST "https://www.******.jp/api/" -d "mobilenumber=<携帯電話番号>&smstext=<本文情報>&username=<接続ユーザーID>&password=<パスワード>"
下記のパラメータだけで最もシンプルな送信が行えます。
パラメータ | 有効値/制限等 | 説明 | 補足 |
---|---|---|---|
username | 英数一部記号 2~20 桁 | 認証時のユーザーネーム | 任意(Basic認証利用の場合は不要) |
password | 英数記号 6~20 桁 | 認証時のパスワード | 任意(Basic認証利用の場合は不要) |
mobilenumber | 数字のみ 11桁番号の場合: 020X, 060X, 070X, 080X,090Xで始まる電話番号(Xの値は1~9) 14桁番号の場合: 0200,0600,0700,0800,0900で始まる電話番号 8180,8190から始まる値の場合:12桁以内 0と上記81以外から始まる値の場合:6~20桁 | SMS送信先電話番号 海外送信時には先頭に国番号を付加する必要があります。(例:81、1等) なお、海外送信につきましては、弊社の方針により新規の利用申請は受付不可であるためご了承いただきますようお願いします。 | 必須 ※海外送信はユーザー権限アカウントにてオプション設定が必要 |
smstext | 140byte 環境依存文字を除くいずれかの値 長文の場合は1340byte | SMS本文 通信キャリア側の仕様により、au以外では本文中に2byte文字が1文字でも存在すると半角全角問わず70文字まで、 Shift_JIS換算で140byteを超えた値は切り捨てられます。 なお、以下の内容を値として指定した場合、 585エラーが返却されます。 ・本文が空の場合 ・改行のみ ・スペースのみ(半角・全角スペースのみ) ・ユーザー権限アカウントに対して「文字数オーバー制限オプション」が有効の状態で、 140byte(長文オプション有効時は1340byte)を超過した文字数を送信しようとした場合 ※長文オプション利用時にはこのパラメータで670文字まで指定できます。長文時にこのパラメータだけ本文として設定することで、4キャリアに送信出来ます。文字数カウントについては、こちらを参照。 | 任意 テンプレートを利用しない個別の本文送信時は必須。 smstextidを使用する場合には使用不可。 文字コードはUTF-8。 byte数はShift_JISで換算し140byte以内(UTF-16からShift_JISへ変換し処理するため) |