コンテンツにスキップ
スマレジ・プラットフォームAPI リファレンス

店舗取得

GET
/shops/{shop_id}
curl --request GET \
  --url 'https://api.smaregi.dev/TARGET-CONTRACT-ID/ec-oms/shops/example?fields=shopId%2CshopName' \
  --header 'Authorization: Bearer <token>'

店舗を取得します。

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
shop_id
required
string
>= 1 characters

店舗ID

Query Parameters

Section titled “Query Parameters”
fields
Array<string>
>= 1 items unique items
Allowed values: shopId shopName ecShopName shopNameShort ecType ecTypeName smaregiShopId

取得するフィールドをカンマ区切りで指定します。 指定がない場合すべてのフィールドを取得します。

Example
?fields=shopId,shopName

Responses

Section titled “Responses”

200

Section titled “200”

取得成功

Media typeapplication/json
Shop
object
shopId

店舗ID

string
>= 1 characters <= 5 characters
shopName

店舗名

string
nullable >= 1 characters <= 50 characters
ecShopName

ECショップ名

string
nullable >= 1 characters <= 50 characters
shopNameShort

店舗名略称

string
nullable >= 1 characters <= 50 characters
ecType

出店モール

string
>= 1 characters <= 5 characters
ecTypeName

出店モール名

string
nullable >= 1 characters <= 50 characters
smaregiShopId

スマレジ店舗ID

string
nullable >= 1 characters <= 5 characters
Examples
Exampledefault
{
  "shopId": "1",
  "shopName": "テスト店舗",
  "ecShopName": "テストECショップ",
  "shopNameShort": "テスト",
  "ecType": "1",
  "ecTypeName": "テストモール",
  "smaregiShopId": "1"
}

400

Section titled “400”

Fieldsに指定外の値が設定されている場合

Media typeapplication/json
object
type
required
string
title
required
string
detail
One of:
string
status
integer
Examples
Examplefieldsに指定外の値が設定されている場合
{
  "type": "about:blank",
  "title": "BadRequest",
  "detail": "指定されたfields項目が不正です: {invalid_field}",
  "status": 400
}

404

Section titled “404”

指定されたIDのリソースが存在しない場合

Media typeapplication/json
object
type
required
string
title
required
string
detail
One of:
string
status
integer
Examples
Example指定したリソースが存在しない場合
{
  "type": "about:blank",
  "title": "NotFound",
  "detail": "指定されたIDのリソースが見つかりません",
  "status": 404
}

500

Section titled “500”

サーバー内部エラー

Media typeapplication/json
object
type
required
string
title
required
string
detail
One of:
string
status
integer
Examples
Exampledefault
{
  "type": "about:blank",
  "title": "InternalServerError",
  "status": 500
}