---
title: "referralCodeInfo"
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/queries/referral-code-info'
  md: 'https://developer.shopline.com/zh-hans-cn/docs/storefront-api/member-system/queries/referral-code-info.md'
---
# referralCodeInfo

根据邀请码，查询对应邀请人。

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

## Arguments

* `customerAccessToken`

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

  获邀人的客户访问令牌。

* `referralCode`

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

  邀请码。

## Returns

* `senderCustomer`

  [ReferralSenderCustomer](https://developer.shopline.com/zh-hans-cn/docs/storefront-api/member-system/objects/referral-sender-customer.md)

  邀请人信息。

## Examples

### 根据邀请码查询对应邀请人

根据邀请码，查询对应邀请人。

**Request:**

```json
query {
  referralCodeInfo(customerAccessToken: "tokenxxx",
   referralCode:"7M2***") {
    senderCustomer{
        customerId
        email
        phone
        firstName
        lastName
        levelName
        levelCode
        referralUrl
        referralCode
    }
  }
}
```

**Response:**

```json
{
  "data": {
    "data": {
      "referralCodeInfo": {
        "senderCustomer": {
          "customerId": "gid://shopline/Customer/42001****",
          "email": "****@qq.com",
          "levelName": "middle",
          "phone": "0086135604****",
          "referralCode": "7M2****",
          "firstName": "zha**",
          "lastName": "mian***",
          "levelCode": "gid://shopline/Membership/MLC64431709****",
          "referralUrl": "https://****.myshopline.com/user/signUp?referral_code=7M2****&source_type=member_plugin_referral&slt=member_plugin_referral"
        }
      }
    }
  }
}
```

## Error Handling

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