2024.07.31
絶対リーチ!®SMS:【2024年12月予定】API仕様変更のご案内(2024月7月31日 続報)
お客様各位
いつも弊社のサービスをご利用いただき、誠にありがとうございます。
絶対リーチ!SMSサービスにおけるAPI仕様の変更の続報をご案内いたします。
「rawdata」項目の廃止に伴い現在公開しております検証環境につきまして、10月以降の再公開のご要望をいただきましたので
公開予定を下記のとおり更新いたしました。
【検証環境の公開予定】
2024年6月27日~2024年8月31日
2024年10月1日~2024年10月31日
※11月以降での再公開についても現在検討しておりますのでご要望ございましたらご連絡ください。
【検証環境の想定】
・CommonMTステータス取得(status.json)
⇒お客様システムより下記URLにごアクセスいただき、「rawdata」項目の無いレスポンスが返りますのでお客様システムが正常に処理できることをご確認ください。
https://test-api.aossms.com/p5/api/status.json?clientTag=2024062601&clientId=606&token=4675995189de89565bc7935895662ebc
⇒CommonMT送信(https://test-api.aossms.com/p5/api/mt.json)をリクエストいただき、
その内容をステータス取得していただくことも可能となりました。
・clientId=606
・smsCode=81032
・token=4675995189de89565bc7935895662ebc
送信とセットで確認されたい場合は下記注意点をご確認の上ご利用ください。
※CommonMT送信により実際に端末には送達いたしません。リクエスト情報を基に送達/失敗のテストデータが作成されます。
※検証環境は全体公開用のため送信した内容は他のお客様からもステータス取得可能です。機密情報に類する内容をmessageやclientTag等に指定しないでください。
※CommonMT送信自体には仕様変更の影響はございません。送信とステータス取得をセットで確認したいお客様向けとなります。
・DLR通知(Common)
⇒個別に通知先の指定が必要になるため、ご要望のお客様は下記宛てにメールをご送付ください。
【宛先】sms2@aicross.co.jp
【件名】「rawdata」項目廃止の検証環境提供依頼
【本文】以下の項目を本文にご記載ください。
・DLR通知先のURL(お客様システムでDLRを受け取れるURL)
・DLR通知形式:xml or json
上記をご連絡いただきましたら個別の検証環境を払い出しますので、そちらへCommonMT送信していただくことで「rawdata」項目が削除されたDLR通知がご指定のURLへ届きます。
※DLR通知の検証のためCommonMT送信により実際に端末には送達いたしません。
・今後のスケジュール
3か月前(2024年9月)に当日の作業スケジュールを周知させていただきます。
1か月前(2024年11月)に検証環境の公開を終了しリマインドメールを送らせていただきます。
2024年12月に変更作業を実施いたします。
以下、第一報と同様の内容となります。
・日時
2024年12月
※詳細な作業日時につきましては9月予定の周知メールにて記載いたします。
・変更内容
・「rawdata」項目の削除
【変更のあるAPI】
・CommonMTステータス取得(status.json)
・DLR通知(Common)
【API仕様書(rawdata削除済)】
API仕様書のページはこちら
※rawdata削除前(現行)のAPI仕様につきましては
こちらご参照ください。
(旧バージョンのAPI仕様書が開きます。)
・変更理由
「rawdata」項目は元々キャリアの通知内容を基に作成しておりましたが、キャリア側の仕様変更によりコードなどの細かい仕様については非公開となったり、通知自体が無くなっており、
お客様の誤解を招く項目となっておりましたので今回正式に廃止(項目削除)することにいたしました。
下記ページでも諸情報をお知らせいたします。
定期的にご確認ください。
メンテナンス・障害情報
https://aicross.co.jp/zettai-reach/notice/
※注記
上記は都合により変更する場合があります。
ご不明点や質問がございましたら、カスタマーサポートまでお気軽にお問い合わせください。
お客様のご理解とご協力に心より感謝申し上げます。
本件に関するお問合せ先はこちらから
以上