API利用ガイド
モバイルダイエットAPIの使用に当たっては、以下の各設定情報が必要となる。
(※使用に際し弊社より発行します)
モバイルダイエットAPIを使用するためには、アプリケーションキーが必要である。
アプリケーションキーは、アプリケーションキーとアプリケーションシークレットからなるペアで、APIへのアクセス権限を認証するために使用される。
APIにおける認証は、次の2つのタイプのいずれか、または認証無しとなる。
APIタイプ | 認証内容 |
ユーザー系API | アプリケーション及びユーザーを認証する |
データ系API | アプリケーションのみを認証する |
認証についてはAPI認証を参照。
モバイルダイエットAPIのエントリポイントは、サーバー名とアクセスコードを使用して構成する。
原則として以下の構成を取る。
APIタイプ | URL |
ユーザー系API | https://(サーバー名)/services/api/(アクセスコード)/ |
データ系API | https://(サーバー名)/services/api/(アクセスコード)/(エントリ) |
アクセスは、IPアドレスに基づいてアクセスを制限できる。
メソッドは使用する機能に応じて GET または POST のいずれかを使用できる。
但し、multipart/form-data でデータを受け渡す際は、POSTを用いる。
以下のリクエストヘッダは必ず送出しなければならない。
Host: (アクセスするAPIのホスト名)
APIで使用する文字コードは原則UTF-8とする。これ以外の文字コードはサポート対象外である。
API中でのハッシュ値の表記は、半角英数0-9a-fを用い、文字列とする。
例: dc7faf3c5cd4a3d5e67a6c53ac919667d748969c
日付の書式は次の通りとし、タイムゾーンはJSTを用いる。
"YYYY/MM/DD" YYYY: 4桁で表記する西暦 MM: 2桁で表記する月(01-12) DD: 2桁で表記する日(01-31)
日付時刻の書式は次の通りとし、タイムゾーンはJSTを用いる。
"YYYY/MM/DD hh:mm:ss" YYYY: 4桁で表記する西暦 MM: 2桁で表記する月(01-12) DD: 2桁で表記する日(01-31) hh: 2桁で表記する時(00-23) mm: 2桁で表記する分(00-59) ss: 2桁で表記する秒(00-59)
特記なき限りjsonまたはxmlを用いる。