サービス基本情報取得

デバイス種別取得

JINS MEMEのデバイス種別一覧を取得するAPIです。

エンドポイント

GET https://apis.jins.com/meme/v1/devices

リクエストヘッダ

名称説明
AcceptString利用可能なアプリケーション・メディアタイプ。
許可された値: “application/json”
AuthorizationStringOAuthのBearerトークン。
許可された値: “Bearer {access_token}”

クエリパラメータ

名称説明
limit オプションNumber最大取得件数。
offset オプションNumber取得開始位置。0始まりで指定します。

リクエストの例

cur -i -X GET "https://apis.jins.com/meme/v1/devices" \
-H "Accept:application/json" \
-H "Authorization:Bearer 24f91wfwg1d36pjyjga57k4164k0q1agd7dbvtjcmt832rh4r33wsspk2m92hd32"

レスポンスボディ

名称説明
devicesArrayデバイスの配列。
 model_typeNumberモデル種別(モデル番号)。
 model_type_nameStringモデル種別名(モデル番号名)。
 model_type_subNumberサブカテゴリ。
 model_type_sub_nameStringサブカテゴリ名。
 device_classStringデバイス機能の種別。”ES”, “MT”など。
 skuStringSKU。
 image_url_productStringMEMEデバイス正面画像URL。プロトコルはHTTPS。
 image_url_product_backStringMEMEデバイス斜め後ろ画像URL。プロトコルはHTTPS。
 image_url_powerStringMEMEデバイス電源ヨリ画像URL。プロトコルはHTTPS。
 orderNumber表示順。
 created_atString作成日時。
RFC3339形式(e.g. 2015-01-01T00:00:00Z)、タイムゾーンはUTCで返却します。
 updated_atString更新日時。
RFC3339形式(e.g. 2015-01-01T00:00:00Z)、タイムゾーンはUTCで返却します。

レスポンスの例

{
  "devices": [
    {
      "model_type":1,
      "model_type_name":"ESウェリントン",
      "model_type_sub":1,
      "model_type_sub_name":"シャイニーブラック",
      "device_class":"ES",
      "sku":"wellingtons-xxx",
      "image_url_product":"http://meme-api-example.s3.amazonaws.com/xxx/product.png",
      "image_url_product_back":"http://meme-api-example.s3.amazonaws.com/xxx/product-back.png",
      "image_url_power":"http://meme-api-example.s3.amazonaws.com/xxx/power.png",
      "order":1,
      "created_at": "2015-01-01T00:00:00Z",
      "updated_at": "2015-01-01T00:00:00Z"
    },
    ...
  ]
}

OFFICIALアプリ情報取得

JINS MEMEの公式アプリケーション情報を取得するAPIです。

エンドポイント

GET https://apis.jins.com/meme/v1/official_applications/:platform

リクエストヘッダ

名称説明
AcceptString利用可能なアプリケーション・メディアタイプ。
許可された値: “application/json”
AuthorizationStringOAuthのBearerトークン。
許可された値: “Bearer {access_token}”

パスパラメータ

名称説明
platformStringプラットフォーム。
許可された値: “ios”, “android”, “watchos”

リクエストの例

curl -i -X GET "https://apis.jins.com/meme/v1/official_applications/ios" \
-H "Accept:application/json" \
-H "Authorization:Bearer ewwrme3ipsozbvlee0xi267xyydj3nbywlfanaciclbjq0e7synziubvs4im2370"

レスポンス

名称説明
official_applicationsArray公式アプリの配列。
 client_idStringJINS MEME公式アプリケーションのID。
 platformStringプラットフォーム。
 nameStringアプリ名。
 image_urlStringアイコン画像URL。プロトコルはHTTPS。
 app_store_urlStringApp StoreのURL。
 versionStringバージョン。
 created_atString作成日時。
RFC3339形式(e.g. 2015-01-01T00:00:00Z)、タイムゾーンはUTCで返却します。
 updated_atString更新日時。
RFC3339形式(e.g. 2015-01-01T00:00:00Z)、タイムゾーンはUTCで返却します。

レスポンスの例

{
  "official_applications":[
    {
      "client_id": "123456789012345",
      "platform": "ios",
      "name": "Jins Drive",
      "image_url": "https://meme-api-example.jins.com/xxx.png",
      "app_store_url": "https://itunes.apple.com/jp/app/idxxxxxxxxxx?mt=",
      "version": "1.0.0",
      "created_at": "2015-01-01T00:00:00Z",
      "updated_at": "2015-01-01T00:00:00Z"
    },
    ...
  ]
}

パーソナル情報取得

ユーザのパーソナル情報を取得するAPIです。

エンドポイント

GET https://apis.jins.com/meme/v1/users/me

リクエストヘッダ

名称説明
AcceptString利用可能なアプリケーション・メディアタイプ。
許可された値: “application/json”
AuthorizationStringOAuthのBearerトークン。
許可された値: “Bearer {access_token}”

リクエストの例

curl -i -X GET "https://apis.jins.com/meme/v1/users/me" \
-H "Accept:application/json" \
-H "Authorization:Bearer si6wz3g3yo658qzslqpuauaj0xw8lss8w0rri16helsf0e5gnffng9f64ynr9o1y"

レスポンスボディ

名称説明
nameStringユーザ名。
emailStringメールアドレス。
profile_image_urlStringプロフィール画像URL。プロトコルはHTTPS。
created_atString作成日時。
RFC3339形式(e.g. 2015-01-01T00:00:00Z)、タイムゾーンはUTCで返却します。
updated_atString更新日時。
RFC3339形式(e.g. 2015-01-01T00:00:00Z)、タイムゾーンはUTCで返却します。
personal_dataObjectパーソナルデータ。
 body_heightNumber身長。
単位はcmです。
 body_height_measurementStringユーザが身長に設定している単位。cm以外が設定されている場合は、body_heightの値をアプリケーションで変換して下さい。
 body_weightNumber体重。単位はkgです。
 body_weight_measurementStringユーザが体重に設定している単位。kg以外が設定されている場合は、body_weightの値をアプリケーションで変換して下さい。
 sexString性別。
 birthdayString生年月日。
 eye_colorString眼の色。
 temperature_measurementStringユーザが温度に設定している単位。C以外が設定されている場合は、temparatureの値をアプリケーションで変換して下さい。
 created_atString作成日時。
RFC3339形式(e.g. 2015-01-01T00:00:00Z)、タイムゾーンはUTCで返却します。
 updated_atString更新日時。
RFC3339形式(e.g. 2015-01-01T00:00:00Z)、タイムゾーンはUTCで返却します。

レスポンスの例

{
  "name": "taro",
  "email": "taro@meme-api-example.jins.com",
  "profile_image_url": "https://meme-api-example.jins.com/xxx/xxx.png",
  "created_at": "Sat, 01 Aug 2015 00:00:00 +0000",
  "updated_at": "Sat, 01 Aug 2015 00:00:00 +0000",
  "personal_data": {
    "body_height": 180.5,
    "body_height_measurement": "cm",
    "body_weight": 80.25,
    "body_weight_measurement": "kg",
    "sex":"Male",
    "birthday": "1980-01-01",
    "eye_color": "Blue",
    "temperature_measurement": "C",
    "created_at": "2015-01-01T00:00:00Z",
    "updated_at": "2015-01-01T00:00:00Z"
  }
}

デバイス識別情報取得

ユーザのデバイス情報を取得するAPIです。

エンドポイント

GET https://apis.jins.com/meme/v1/users/me/devices

リクエストヘッダ

名称説明
AcceptString利用可能なアプリケーション・メディアタイプ。
許可された値: “application/json”
AuthorizationStringOAuthのBearerトークン。
許可された値: “Bearer {access_token}”

クエリパラメータ

名称説明
mac_address オプションStringJINS MEMEデバイスのMACアドレス。このパラメータが指定された場合、offset,limitは無視されます。
uuid オプションStringJINS MEMEデバイスのUUID。このパラメータが指定された場合、offset,limitは無視されます。
limit オプションNumber最大取得件数。
デフォルト値: 20
値の範囲: 1-100
offset オプションNumber取得開始位置。0始まりで指定します。

リクエストの例

curl -i -X GET "https://apis.jins.com/meme/v1/users/me/devices"  \
-H "Accept:application/json" \
-H "Authorization:Bearer si6wz3g3yo658qzslqpuauaj0xw8lss8w0rri16helsf0e5gnffng9f64ynr9o1y"

レスポンス

名称説明
user_devicesArrayユーザデバイスの配列。
 model_typeNumberモデル種別(モデル番号)。
 model_type_subNumberサブカテゴリ。
 skuStringSKU。
 mac_addressStringJINS MEMEデバイスのMACアドレス。
 uuidsArray(String)JINS MEMEデバイスに紐付いたUUID。複数のスマホにインストールされたアプリから使用する場合はひとつのJINS MEMEデバイスに複数のUUIDが紐付きます。
 users_device_nameStringユーザが付与したJINS MEMEデバイス識別名。
 created_atString作成日時。
RFC3339形式(e.g. 2015-01-01T00:00:00Z)、タイムゾーンはUTCで返却します。
 updated_atString更新日時。
RFC3339形式(e.g. 2015-01-01T00:00:00Z)、タイムゾーンはUTCで返却します。

レスポンスの例

{
  "user_devices": [
    {
      "model_type":1,
      "model_type_sub":1,
      "sku":"wellingtons-xxx",
      "mac_address": "32:61:3C:4E:B6:05",
      "uuids": ["68753A44-4D6F-1226-9C60-0050E4C00067"]
      "users_device_name": "私のMEME",
      "created_at": "2015-01-01T00:00:00Z",
      "updated_at": "2015-01-01T00:00:00Z"
    },
    ...
  ]
}