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

配送業者取得

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

配送業者を取得します。

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

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

配送業者ID

Query Parameters

Section titled “Query Parameters”
fields
Array<string>
>= 1 items unique items
Allowed values: delivTransId delivTransName

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

Example
?fields=delivTransId,delivTransName

Responses

Section titled “Responses”

200

Section titled “200”

取得成功

Media typeapplication/json
DeliveryCompany
object
delivTransId

配送業者ID

string
>= 1 characters <= 9 characters
delivTransName

配送業者名

string
>= 1 characters <= 50 characters
Examples
Exampledefault
{
  "delivTransId": "1000",
  "delivTransName": "テスト配送業者"
}

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
}