従量課金 API

Overview

本APIは、NTT Com各種サービスの従量課金情報¹を管理するAPIです。

Resource URL

グローバル共通ドメインの利用、または個別リージョンドメインをご利用ください。

グローバル共通ドメインを利用する場合、お客様のご利用箇所の状況に応じて、
一番近いAPIゲートウェイに接続します。

1.Base Path(Global Load Balance)

https://api.ntt.com/v1/business-process/pay-per-use

2.Base Path(Region)

https://{region}.api.ntt.com/v1/business-process/pay-per-use

• region is jp|us|fr|sg
• e.g. https://us.api.ntt.com/v1/business-process/pay-per-use
• 指定できるregionは、将来拡充予定

Resource Information

• #1 お客さま接続単位で適切な流量制限を実施

従量課金情報参照

GET /v1/business-process/pay-per-use/{contractId}

Request Parameters

• #1 ell-flexible　他のサービスは順次拡充予定。（2016/4 現在）
• #2 利用年月を指定を指定しない場合、当月分と前月分の2ヶ月分の従量課金情報を返却

Example Request

 GET /v1/business-process/pay-per-use/N*********?serviceName=ell-flexible

Response Parameters

• #1 下記コードを設定。

  Code	Name	Description
  000000	正常	処理が正常に完了した。
  100000	該当データ無し	処理対象のデータが存在しなかった。(準正常)
  111000	業務規制	業務規制中を検出した。(準正常)
  910000	パラメータエラー	パラメータフォーマットエラーを検出した。(異常)
  920000	リソースエラー	DBなどリソースアクセス時にエラーが発生した。(異常)
  930000	内部矛盾エラー	内部処理矛盾が発生した。(異常)
  990000	その他エラー	上記以外の例外エラー発生。(異常)

• #2 処理結果正常時のみ本パラメータが設定される。

• #3 YYYYMM(6桁)形式で設定。
• #4 当該利用期間に使用した帯域をMbps単位で設定。
• #5 当該利用期間に使用した帯域と基準品目との差をMbps単位で設定。
• #6 MMDD(4桁)形式で設定。

Example Result

{
    "chargeAmountInfo": [
        {
            "row": {
                "billContractId": "N*********", 
                "chargeAmount": "19354", 
                "useYearmonth": "201603"
            }
        }
    ], 
    "chargeItemAmountInfo": [
        {
            "row": {
                "accessLineKind": "000160", 
                "addBandwidth": "0", 
                "billContractId": "N*********", 
                "billItem": "0", 
                "chargeItemAmount": "19354", 
                "effectiveDate": "0314", 
                "terminationDate": "0317", 
                "useBandwidth": "500", 
                "useYearmonth": "201603"
            }
        }
    ], 
    "result": "000000"
}