---
title: "删除客户数据（GDPR规范）"
description: "数据合规强制订阅webhook"
doc_type: openapi
doc_category: openapi
doc_version: v20260901
source_url:
  html: 'https://developer.shopline.com/zh-hans-cn/docs/webhook/customers/delete-customer-data-gdpr-specification'
  md: 'https://developer.shopline.com/zh-hans-cn/docs/webhook/customers/delete-customer-data-gdpr-specification.md'
---
# 删除客户数据（GDPR规范）

数据合规强制订阅webhook

- **API Version:** v20260901
- **API Type:** Webhook
- **API Protocol:** RESTful

## Request

### Request Headers

* `X-Shopline-Topic`

  string (required)

  事件的唯一标识。

* `X-Shopline-Hmac-Sha256`

  string (required)

  该请求的签名。收到请求后，你需要对该签名进行 [验签](https://developer.shopline.com/zh-hans-cn/docs/apps/api-instructions-for-use/generate-and-verify-signatures.md#post-请求操作步骤) 以验证数据的真实性和完整性。

* `X-Shopline-Shop-Domain`

  string (required)

  店铺的域名。

* `X-Shopline-Shop-Id`

  string (required)

  店铺 ID。

* `X-Shopline-Merchant-Id`

  string (required)

  商家 ID。

* `X-Shopline-API-Version`

  string (required)

  API 版本号。

* `X-Shopline-Webhook-Id`

  string (required)

  该 Webhook 事件的 ID。

### Request Body

* `customer`

  object

  客户信息

  * `email`

    string

    邮箱

  * `id`

    string

    客户id

  * `phone`

    string

    手机号

* `orders_to_redact`

  array<string>

  自定义单号

* `shop_domain`

  string

  店铺域名

* `shop_id`

  string

  店铺id

* `update_time`

  string

  更新时间

## Response

### Status Codes

* `200`

  收到 SHOPLINE 发送的 Webhook 通知后，你需要按照如下 SHOPLINE 要求的格式进行响应。
  
  ``` HTTP/1.1 200 OK ``` 
  
  关于如何订阅 Webhooks 及更多 Webhook 响应规则说明，请参考 [Webhook 概述](https://developer.shopline.com/zh-hans-cn/docs/apps/api-instructions-for-use/webhooks/overview.md)。

### Response Body

#### 200

_No response body_

## OpenAPI Definition

```json
{
  "description": "数据合规强制订阅webhook",
  "externalDocs": {
    "description": "| 事件分组 | 事件标识 |\n| :------: | :------: |\n|customers        |customers/redact        |\n",
    "url": "",
    "errorTableDescription": ""
  },
  "operationId": "EtN10U55",
  "parameters": [
    {
      "name": "X-Shopline-Topic",
      "in": "header",
      "description": "事件的唯一标识。",
      "required": true,
      "style": "string",
      "schema": {
        "name": "X-Shopline-Topic",
        "description": "事件的唯一标识。",
        "type": "string",
        "example": "orders/edited"
      },
      "example": "orders/edited"
    },
    {
      "name": "X-Shopline-Hmac-Sha256",
      "in": "header",
      "description": "该请求的签名。收到请求后，你需要对该签名进行 [验签](https://developer.shopline.com/zh-hans-cn/docs/apps/api-instructions-for-use/generate-and-verify-signatures.md#post-请求操作步骤) 以验证数据的真实性和完整性。",
      "required": true,
      "style": "string",
      "schema": {
        "name": "X-Shopline-Hmac-Sha256",
        "description": "该请求的签名。收到请求后，你需要对该签名进行 [验签](https://developer.shopline.com/zh-hans-cn/docs/apps/api-instructions-for-use/generate-and-verify-signatures.md#post-请求操作步骤) 以验证数据的真实性和完整性。",
        "type": "string",
        "example": "XWmrwMey6OsLMeiZKwP4FppHH3cmAiiJJAweH5Jo4bM="
      },
      "example": "XWmrwMey6OsLMeiZKwP4FppHH3cmAiiJJAweH5Jo4bM="
    },
    {
      "name": "X-Shopline-Shop-Domain",
      "in": "header",
      "description": "店铺的域名。",
      "required": true,
      "style": "string",
      "schema": {
        "name": "X-Shopline-Shop-Domain",
        "description": "店铺的域名。",
        "type": "string",
        "example": "example.myshopline.com"
      },
      "example": "example.myshopline.com"
    },
    {
      "name": "X-Shopline-Shop-Id",
      "in": "header",
      "description": "店铺 ID。",
      "required": true,
      "style": "string",
      "schema": {
        "name": "X-Shopline-Shop-Id",
        "description": "店铺 ID。",
        "type": "string",
        "example": "1610418123456"
      },
      "example": "1610418123456"
    },
    {
      "name": "X-Shopline-Merchant-Id",
      "in": "header",
      "description": "商家 ID。",
      "required": true,
      "style": "string",
      "schema": {
        "name": "X-Shopline-Merchant-Id",
        "description": "商家 ID。",
        "type": "string",
        "example": "2000001234"
      },
      "example": "2000001234"
    },
    {
      "name": "X-Shopline-API-Version",
      "in": "header",
      "description": "API 版本号。",
      "required": true,
      "style": "string",
      "schema": {
        "name": "X-Shopline-API-Version",
        "description": "API 版本号。",
        "type": "string",
        "example": "v20250601"
      },
      "example": "v20250601"
    },
    {
      "name": "X-Shopline-Webhook-Id",
      "in": "header",
      "description": "该 Webhook 事件的 ID。",
      "required": true,
      "style": "string",
      "schema": {
        "name": "X-Shopline-Webhook-Id",
        "description": "该 Webhook 事件的 ID。",
        "type": "string",
        "example": "b54557e48a5fbf7d70bcd043"
      },
      "example": "b54557e48a5fbf7d70bcd043"
    }
  ],
  "requestBody": {
    "content": {
      "application/json": {
        "schema": {
          "type": "object",
          "properties": {
            "customer": {
              "name": "customer",
              "description": "客户信息",
              "type": "object",
              "properties": {
                "email": {
                  "name": "email",
                  "description": "邮箱",
                  "type": "string",
                  "example": "gungcherny@gamil.com"
                },
                "id": {
                  "name": "id",
                  "description": "客户id",
                  "type": "string",
                  "example": "200843728"
                },
                "phone": {
                  "name": "phone",
                  "description": "手机号",
                  "type": "string",
                  "example": "00165323713"
                }
              },
              "example": {
                "email": "gungcherny@gamil.com",
                "id": "200843728",
                "phone": "00165323713"
              }
            },
            "orders_to_redact": {
              "name": "orders_to_redact",
              "description": "自定义单号",
              "type": "array",
              "items": {
                "name": "orders_to_redact",
                "description": "自定义单号",
                "type": "string",
                "example": "#72348"
              },
              "example": [
                "#72348"
              ]
            },
            "shop_domain": {
              "name": "shop_domain",
              "description": "店铺域名",
              "type": "string",
              "example": "sgbm008.myshopline.com"
            },
            "shop_id": {
              "name": "shop_id",
              "description": "店铺id",
              "type": "string",
              "example": "160943274324"
            },
            "update_time": {
              "name": "update_time",
              "description": "更新时间",
              "type": "string",
              "example": "2022-05-31T15:32:46+08:00"
            }
          },
          "example": {
            "customer": {
              "email": "gungcherny@gamil.com",
              "id": "200843728",
              "phone": "00165323713"
            },
            "orders_to_redact": [
              "#72348"
            ],
            "shop_domain": "sgbm008.myshopline.com",
            "shop_id": "160943274324",
            "update_time": "2022-05-31T15:32:46+08:00"
          }
        }
      }
    },
    "required": true
  },
  "responses": {
    "200": {
      "description": "收到 SHOPLINE 发送的 Webhook 通知后，你需要按照如下 SHOPLINE 要求的格式进行响应。\n\n``` HTTP/1.1 200 OK ``` \n\n关于如何订阅 Webhooks 及更多 Webhook 响应规则说明，请参考 [Webhook 概述](https://developer.shopline.com/zh-hans-cn/docs/apps/api-instructions-for-use/webhooks/overview.md)。"
    }
  },
  "info": {
    "title": "删除客户数据（GDPR规范）",
    "version": "v20260901"
  }
}
```