重定向

重定向导致商店站点上特定路径上的访问者被自动发送到另一个位置（称为target）。目标可以是商店网站上的新路径或完整的URL。新的URL甚至可以位于完全不同的域中。重定向路径是唯一的，因此一家商店最多只能使用同一条路径进行重定向。

重定向可以做什么

Shopify API使您可以使用重定向资源执行以下操作。这些常规操作的更详细的版本可能可用：

重定向属性

ID 只读 plain "id": 304339089 重定向的ID。
小路 plain "path": "/products.php" 要重定向的旧路径。当用户访问此路径时，他们将被重定向到目标。（最多1024个字符）
目标 plain "target": "/products" 用户将被重定向到的目标位置。当用户访问该path属性指定的旧路径时，他们将被重定向到该位置。可以将此属性设置为商店网站上的任何路径，也可以设置为外部URL。（最多255个字符）

终点

得到/admin/api/2021-01/redirects.json 检索URL重定向列表。注意：从2019-10版本开始，此端点通过使用响应标头中提供的链接来实现分页。发送<font style="background-color:#F4F6F8;">page</font>参数将返回错误。要了解更多信息，请参阅向分页的REST Admin API端点发出请求。
限制 要显示的最大结果数。
（默认值：50
最大：250
）
since_id 将结果限制为指定的ID之后。
小路 显示具有给定路径的重定向。
目标 显示具有给定目标的重定向。
领域 仅显示某些字段，这些字段由逗号分隔的字段名称列表指定。

检索所有重定向的列表

GET /admin/api/2021-01/redirects.json

查看回应

检索指定ID后的URL重定向列表

GET /admin/api/2021-01/redirects.json?since_id=668809255

查看回应

得到/admin/api/2021-01/redirects/count.json 检索URL重定向次数
小路 用给定路径计数重定向。
目标 计算具有指定目标的重定向。

计算所有重定向

GET /admin/api/2021-01/redirects/count.json

查看回应

得到/admin/api/2021-01/redirects/{redirect_id}.json 检索单个重定向
领域 仅显示某些字段，这些字段由逗号分隔的字段名称列表指定。

通过ID检索单个重定向

GET /admin/api/2021-01/redirects/668809255.json

查看回应

邮政/admin/api/2021-01/redirects.json 创建重定向。当提供完整的URL作为<font style="background-color:#F4F6F8;">path</font>属性的值时，它将被保存为没有域的绝对路径。例如，<font style="background-color:#F4F6F8;">"path": "http://www.johns-apparel.com/springwear"</font>将另存为<font style="background-color:#F4F6F8;">"path": "springwear"</font>。

使用路径的完整URL创建重定向，该重定向将保存为没有域的绝对路径

POST /admin/api/2021-01/redirects.json

{

“重定向” ： {

  1. “路径” ：“ [http://www.apple.com/forums](http://www.apple.com/forums)”，
  3. “ target” ：“ [http://forums.apple.com](http://forums.apple.com)”

}

}

查看回应

创建没有路径或目标的重定向失败并返回错误

POST /admin/api/2021-01/redirects.json

{

“重定向” ： {

  1. “ body” ：“ foobar”

}

}

查看回应

创建重定向

POST /admin/api/2021-01/redirects.json

{

“重定向” ： {

  1. “路径” ：“ / ipod”，
  3. “ target” ：“ / pages / itunes”

}

}

查看回应

放/admin/api/2021-01/redirects/{redirect_id}.json 更新现有的重定向

更新重定向的路径URI

PUT /admin/api/2021-01/redirects/668809255.json

{

“重定向” ： {

  1. “ id” ：668809255，
  3. “路径” ：“ /老虎”

}

}

查看回应

更新重定向的路径和目标URI

PUT /admin/api/2021-01/redirects/950115854.json

{

“重定向” ： {

  1. “ id” ：950115854，
  3. “路径” ：“ / powermac”，
  5. “ target” ：“ / pages / macpro”

}

}

查看回应

删除/admin/api/2021-01/redirects/{redirect_id}.json 删除重定向

删除现有的重定向

删除/admin/api/2021-01/redirects/668809255.json

查看回应