API リクエストの認証・認可を行う

🚧

こちらの機能はリリース前のβ機能となります

導入を検討されているお客様は営業担当までお問い合わせください。
また、今後予告なく仕様変更を伴う機能改善が行なわれる可能性があります。ご了承ください。

事前準備

以下の条件を満たす KARTE Apps を作成しておく

  • 対象となる API が Scope に付与されている
  • 対象となるプロジェクトのアクセストークンを保持している

API リクエストの実装例

Track API の場合

指定したイベントを発生させるサンプルコードを以下に記載します。

const http = require('https');
const ACCESS_TOKEN = 'サービスアカウントのアクセストークン';

function trackEvents(keys, events) {
  const body = JSON.stringify({
    client_id: 'サービスアカウントのclient_id',
    api_key: 'プロジェクトのapi_key',
    keys: keys,
    events: events
  });

  const authorizationHeader = 'Bearer ' + ACCESS_TOKEN;

  const headers = {
    'Content-Type': 'application/json; charset=utf-8',
    'Authorization': authorizationHeader
  };

  const options = {
    hostname: 'api.karte.io',
    path: '/v1/event/track',
    method: 'POST',
    headers: headers
  };

  const req = http.request(options, (res) => {
    res.setEncoding('utf8');
    res.on('data', (chunk) => {
      console.log(chunk);
    });
  });

  req.write(body);
  req.end();
}

const keys = {
  user_id: 'イベントを発生させるユーザーのuser_id'
};  // イベントを発生させるユーザーとの紐付け情報

const events = [{
  event_name: '発生させるイベントの名称',
  values: {
    item_id: '123',
    name: 'hoge',
    price: 10000,
    quantity: 1
  }
}]; // keysで紐付ける特定のユーザーに対して、最大10イベントまで同時に指定可能

trackEvents(keys, events);

Message API の場合

ユーザーにメッセージを送信する をご確認ください。

Assign API の場合

ユーザーの担当者を変更する をご確認ください。