---
title: "shop"
description: "查询店铺的信息。你可以使用该接口查询店铺 ID、店铺名称、结算币种等信息。"
doc_type: graphql
doc_category: adminGraphQL
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/store-properties/queries/shop'
  md: 'https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/store-properties/queries/shop.md'
---
# shop

查询店铺的信息。你可以使用该接口查询店铺 ID、店铺名称、结算币种等信息。

- **API Version:** v20270301
- **API Type:** Admin
- **API Protocol:** GraphQL
- **Operation Type:** Query

## Returns

* `contactEmail`

  [String!](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/string.md)

  商家的邮箱，用于与顾客联系。

* `name`

  [String!](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/string.md)

  店铺的名称。

* `handle`

  [String!](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/string.md)

  店铺的唯一标识符，值为店铺域名的前缀。例如，域名为  `open001.myshopline.com` 的店铺，其 `handle` 是 `open001`。

* `id`

  [ID!](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/id.md)

  店铺的唯一 ID。

* `currencyCode`

  [CurrencyCode!](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common-objects/enums/currency-code.md)

  店铺与顾客结算的货币。该字段值为三位币种码，遵循 [`ISO 4217`](https://en.wikipedia.org/wiki/ISO_4217) 标准，例如 `CNY`。

* `ianaTimezone`

  [String!](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/string.md)

  店铺配置的时区。

* `allProductCategories`

  [[ProductCategory!]](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/products-and-collections/objects/product-category.md)

  店铺商品的标准类型列表。
  <br></br>最大个数限制：1000。

* `features`

  [ShopFeatures!](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/store-properties/objects/shop-features.md)

  店铺功能的可用情况。例如，`giftCards` 返回 `true` 表示允许在商店中创建礼品卡。

* `resourceLimits`

  [ShopResourceLimits!](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/store-properties/objects/shop-resource-limits.md)

  店铺下特定资源的限制情况。

* `uploadedImagesByIds`

  [[Image!]](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common-objects/objects/image.md)

  上传到商店的图像列表。

* `productTypes`

  [StringConnection!](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common-objects/objects/string-connection.md)

  店铺商品已添的自定义商品类型列表。

* `productTags`

  [StringConnection!](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common-objects/objects/string-connection.md)

  店铺商品已添加到商品标签列表。

* `productVendors`

  [StringConnection!](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common-objects/objects/string-connection.md)

  店铺商品已添加到商品供应商列表。

## Examples

### 查询店铺名称、ID、联系邮箱、币种、handle、时区、可用功能信息。

查询店铺的信息。你可以使用该接口查询店铺ID、店铺名称、结算币种等信息。

**Request:**

```json
query Shop {
    shop {
       contactEmail
       name
       handle
       id
       currencyCode
       ianaTimezone
       allProductCategories {
        productTaxonomyNode {
            isRoot
            name
            fullName
            id
            isLeaf
        }
       }
       features {
        giftCards
        shopId
       }
       resourceLimits {
        maxProductOptions
        maxProductVariants
        shopId
       }
    }
}
```

**Response:**

```json
{
  "data": {
    "data": {
      "shop": {
        "handle": "openapiceshidianpu",
        "allProductCategories": [
          {
            "productTaxonomyNode": {
              "isLeaf": true,
              "isRoot": false,
              "name": "Gift Cards & Certificates",
              "fullName": "Gift Giving < Party & Celebration < Arts & Entertainment < Gift Cards & Certificates",
              "id": "gid://shopline/ProductTaxonomyNode/53"
            }
          }
        ],
        "currencyCode": "USD",
        "name": "OpenAPI 测试店铺",
        "ianaTimezone": "Asia/Shanghai",
        "id": "1672369729606",
        "resourceLimits": {
          "maxProductOptions": 5,
          "maxProductVariants": 500,
          "shopId": "1672369729606"
        },
        "contactEmail": "ssc56474@gmail.com",
        "features": {
          "shopId": "1672369729606",
          "giftCards": true
        }
      }
    },
    "extensions": {
      "cost": {
        "actualQueryCost": 6,
        "requestedQueryCost": 6,
        "throttleStatus": {
          "currentlyAvailable": 4994,
          "maximumAvailable": 5000,
          "restoreRate": 5000
        }
      }
    }
  }
}
```

## Error Handling

关于更多通用错误码说明，参考：[状态码和错误码](https://developer.shopline.com/zh-hans-cn/docs/apps/api-instructions-for-use/graph-ql-admin-api/overview.md#status-and-error-codes)。