API Test とは

その名の通り、API のテストに特化した機能です。雰囲気としては、前回紹介した、Scripted Browser と同じです。専用のスクリプトを書いて、それを定期的に実行するというものです。API のテストに特化した変数などが用意されている点が違います。

New Relic Synthetics では、HTTP リクエストの送信と結果の検証に [http-request}(https://github.com/request/request) モジュールを使っています。それらは、$http オブジェクトを使って利用します。

これも Scripted Browser と同じで、JS ベースでスクリプトを書いていきます。

使い方

これまでのチェック方法(Ping モニターや Scripted Browser)と同様に、テスト名、実行地域、実行頻度、アラート通知の設定を行っていきます。詳しくは、New Relic Synthetics: 無料のPingモニターでサイトの稼働状況をらくらくチェックをご覧ください。（なんか最近、地域の設定（Select monitoring locations）が表示されないのは僕だけだろうか。何回か画面更新してたら出てきた）

設定できたら、"Next: Write your script" ボタンを押して、スクリプト作成画面に移動します。

これは、前回の Scripted Browser で見たのとまったく同じ画面ですね。（もちろん中身のスクリプトは違うけど）

この状態で、徐に "Validate" ボタンを押してみます。

実行結果とレスポンスが確認できますね。

次はあえて、間違えてみます。以下の様にエラーは表示されます。だいたい Scripted Browser と同じ感じですね。

サンプルスクリプト

上記で試したサンプルのスクリプトは以下のようになっています。参考まで。

/**
 * Feel free to explore, or check out the full documentation
 * https://docs.newrelic.com/docs/synthetics/new-relic-synthetics/scripting-monitors/writing-api-tests
 * for details.
 */

var assert = require('assert');

$http.post('http://httpbin.org/post',
  // Post data
  {
    json: {
      widgetType: 'gear',
      widgetCount: 10
    }
  },
  // Callback
  function (err, response, body) {
    assert.equal(response.statusCode, 200, 'Expected a 200 OK response');

    console.log('Response:', body.json);
    assert.equal(body.json.widgetType, 'gear', 'Expected a gear widget type');
    assert.equal(body.json.widgetCount, 10, 'Expected 10 widgets');
  }
);

Komoju で試して見る

サンプルの説明だけだと、あまり書く事ないので、今回はちょうど別の Advent Calendarで弊社の決済サービスKomoju のAPIの使い方「決済 API Komoju を使って決済してみる」を紹介していたので、それを使ってテストをしてみたいと思います。

スクリプト

var assert = require('assert');

var data = {
  "amount":1000,
  "currency":"JPY",
  "payment_details[type]":"credit_card",
  "payment_details[family_name]":"Yamada",
  "payment_details[given_name]":"Taro",
  "payment_details[month]":"01",
  "payment_details[year]":"2016",
  "payment_details[number]":"4111111111111111",
  "payment_details[verification_value]":123
};

var options = {
    uri: 'https://sandbox.komoju.jp/api/v1/payments.json',
    auth : { user: "[your_secret_key]"},
    form: data
};

$http.post(options,
  function (err, response, body) {
    assert.equal(response.statusCode, 200, 'Expected a 200 OK response');

    console.log('Response:', body);
    var json = JSON.parse(body);
    assert.equal(json.status, 'captured', 'Payment is captured');
    assert.equal(json.total , 1080, 'Total includes tax');
  }
);