Motimate：Motimate Public API の使用方法

Public API を使用して、ユーザー統合とデータソースとの同期を自動化し、Motimate を他の優れたサービスに接続します。

Public API は、Motimate のデータを更新および管理するために使用できる一連のサービスです。 これはOpenAPIと呼ばれる標準的な方法で文書化されており、開発者に私たちのソフトウェアへのプログラム的なアクセスをサービスとして提供します。 このAPIは、SCIMやCSVでできることよりも幅広いサポートを持っているが、これを使うには統合サービスやソフトウェア・ロボットが必要だ。

PAPI v2の発表により、MotiSpaceからのデータエクスポートがこれまで以上に簡単になりました：

• /モティス/プログレス
• /motis/chapter_completions
• /投稿そして
• /insights/learnings/report_requests

データモデル

公開APIは、ユーザープロビジョニングとパルス投稿を自動化するモデルを提供します。 これらのデータモデルを持っている：

• ユーザー・モデル：ユーザーアカウントに関する情報の読み取り、書き込み、更新に使用できます。 これには、連絡先情報、アクセス・ロール、モチ管理のためのグループ割り当てを含めることができる。 ユーザーが1つまたは複数のポジションを持っている場合、このエンドポイントで設定することもできます。
   
• Groupsモデル： これにより、ユーザーグループの読み取り、書き込み、割り当てが可能になります。 これらのグループは、組織に合わせてツリー構造にして、学習課題を簡素化することもできます。 
  
  重要： グループ・レベルは現在、属性の種類を使用して定義されています。 現物の 価値は組織によって異なる。 また、組織の管理者が簡単に変更することもできます。 API統合をセットアップする際、種類名が変更された場合にAPI統合でエラーが発生する可能性を避けるため、グループレベルの種類 名の永続的なリストを定義することをお勧めします。
   
• ポジション・モデル：このモデルでは、ユーザーアカウントを割り当てることができるポジションを読み書きすることができます。
   
• 投稿：この機能を使って投稿を作成し、Pulseで公開することができます。 これは、画像をアップロードするためのファイルサービスと組み合わせて行うことができます。
   
• ファイルこのサービスは、パルス投稿用の画像をアップロードするために使用されます。 画像のサイズ制限は40MB、ビデオは100MB、ドキュメントは100MBです。
   
• インサイトこのサービスは、カスタマイズされたレポートへのリンクを生成し、取得するために使用されます。 レポートテンプレートは、Motimateプラットフォームで「インサイト」の「レポートの生成」機能を使用して事前に作成する必要があります。

認証

アクセストークンの作成にはOAuth Tokenエンドポイントを 使用します。 support@motimateapp.com、client_idと client_secretを取得してください。

これらの詳細情報を受け取ると、トークンをプログラム的に、またはPostmanなどのプラットフォームを介して生成することができます。 必要なのは、APIコールを POST /oauth/tokens エンドポイントにAPIコールを送信するだけです。

APIは、24時間有効なユニークトークンで応答します。 トークンは必要なだけ生成できる。 このトークンは、他のすべてのエンドポイントへのリクエストでBearerトークンとしてAuthorizationヘッダーに渡されなければなりません（"Bearer "+[your_token]）。

例
"ベアラーeyJhbkyFjHk0oIY6ghkkgRI1NiJ9.eyJ0b23Lo7G5jk7mJkYzdiZD"
 

あなたは GET /me エンドポイント はアクセストークンの検証に使われます。 これは、アクセストークンを保管するキーストアがあり、トランザクション・コールを呼び出さずに動作していることを確認したい場合に便利である。