NexmoのNode.jsサーバーSDKがホストのオーバーライドをサポートしました。

最近リリースした v2.6.0をリリースしました。をリリースし、HTTPリクエストに使用するホストを変更する機能を追加しました。

なぜですか？

この機能により、デフォルトのホストを上書きすることができます、 api.nexmo.comおよび rest.nexmo.comを上書きすることができます。この機能の最も一般的な使用例の1つは、ロードバランサーをバイパスして、例えば、当社のロケーション固有のデータセンターの1つに向かってHTTPリクエストを行うことです、 api-sg-1.nexmo.com.

私たちの "NCCOで発信電話をかける"コード・スニペットを見て、電話をかけるときにシンガポール・データセンターを使うように変更してみましょう。

const Nexmo = require('nexmo')

const nexmo = new Nexmo({
  apiKey: NEXMO_API_KEY,
  apiSecret: NEXMO_API_SECRET,
  applicationId: NEXMO_APPLICATION_ID,
  privateKey: NEXMO_APPLICATION_PRIVATE_KEY_PATH
}, {
  apiHost: 'api-sg-1.nexmo.com'
})

nexmo.calls.create({
  to: [{
    type: 'phone',
    number: TO_NUMBER
  }],
  from: {
    type: 'phone',
    number: NEXMO_NUMBER
  },
  ncco: [{
    "action": "talk",
    "text": "This is a text to speech call from Nexmo"
  }]
});

よく見ると、コード・スニペットに加えた唯一の変更は、オプション・オブジェクトを Nexmoインスタンスに apiHostプロパティを持つ

この機能のもう一つの一般的な使用例は、プロキシやゲートウェイを使用して、リクエストをNexmo APIに渡す前に検査することです。では curlhubを使ってすべての API トラフィックを検査してみましょう。

curlhub interface

サインアップすると、curlhubから Bucket Id.例えば n43s3qc13thd.をプロキシしたいホストに付加します。つまり api.nexmo.comとすると、対応する curlhub ホストは api-nexmo-com-n43s3qc13thd.curlhub.io.同じロジックが rest.nexmo.comで、対応する curlhub ホストは rest-nexmo-com-n43s3qc13thd.curlhub.io.

SDKが行うリクエストのプロキシとしてこれらを使用するためには apiHostと restHostプロパティを new Nexmoインスタンスに

const Nexmo = require('nexmo')

const nexmo = new Nexmo({
  apiKey: NEXMO_API_KEY,
  apiSecret: NEXMO_API_SECRET,
  applicationId: NEXMO_APPLICATION_ID,
  privateKey: NEXMO_APPLICATION_PRIVATE_KEY_PATH
}, {
  apiHost: 'api-nexmo-com-n43s3qc13thd.curlhub.io',
  restHost: 'rest-nexmo-com-n43s3qc13thd.curlhub.io'
})

次の記事

私たちはNode.js SDKの改善に取り組んでいます。 https://github.com/nexmo/nexmo-node.何かご提案や問題がありましたら、GitHub または コミュニティ・スラック.