---
title: "MembershipInfo"
description: "单个客户所在等级的信息。"
doc_type: graphql
doc_category: storefront
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/zh-hans-cn/docs/storefront-api/member-system/objects/membership-info'
  md: 'https://developer.shopline.com/zh-hans-cn/docs/storefront-api/member-system/objects/membership-info.md'
---
# MembershipInfo

单个客户所在等级的信息。

- **API Version:** v20270301
- **API Type:** Storefront
- **API Protocol:** GraphQL
- **Operation Type:** Object

## Type Signature

`MembershipInfo`

## Fields

* `invitedSuccess`

  [UnsignedInt64](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/unsigned-int-64.md)

  店铺内由该客户邀请成功的用户数。即，收到邀请，并且成功完成商家设置的邀请任务的总成功次数

* `levelCode`

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

  该客户所在的等级会员或付费会员编码

* `levelExpiryTime`

  [Date](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/date.md)

  该客户所在的等级会员或付费会员到期时间。当membershipType = LEVEL 时，如果 levelExpiryTime 为空，代表永久有效

* `levelIcon`

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

  该客户所在的等级会员或付费会员的icon

* `levelName`

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

  该客户所在的等级会员或付费会员名称。最多25个字符

* `levelOrder`

  [Int](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/int.md)

  仅当 membershipType = LEVEL 时有意义，此时 levelOrder 越大，等级越高级

* `levelUpdatedTime`

  [Date](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/date.md)

  该客户所在的等级会员或付费会员开始生效时间

* `membershipType`

  [MembershipType](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/member-system/enums/membership-type.md)

  店铺当前使用的会员机制。

* `rewardAvailable`

  [Int](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/common/scalars/int.md)

  该客户当前可用的奖励个数。奖励的范围包括：下发的会员权益、已通过积分兑换优惠券等

## Schema Definition

```graphql
type MembershipInfo { 
	invitedSuccess: UnsignedInt64
	levelCode: String
	levelExpiryTime: Date
	levelIcon: String
	levelName: String
	levelOrder: Int
	levelUpdatedTime: Date
	membershipType: MembershipType
	rewardAvailable: Int 
}
```

## Field from

* [Query](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/member-system/queries/member-info.md).memberInfo

  查询单个会员的会员资产信息，包括会员等级和付费类型信息、可使用的奖励和推荐信息等

## Error Handling

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