App Store Server API AI 员工

Leina 连接 App Store Server API，帮你解释购买记录、核对订阅问题。在团队聊天中交代任务，Leina 完成工作，再把结果带回来。

开始使用浏览全部集成

连接 App Store Server API，选择要共享的内容，就可以交代第一项任务。

Leina + App Store Server API 结果示例

你

检查交易 [交易编号]，整理客户的订阅历史与当前状态，供客服回复使用。

Leina

已核对购买历史和订阅记录，最新订阅处于有效状态。

App Store · 客服摘要

客户订阅

订阅记录已体现最近一次续费。

购买历史: 包含首次购买及后续续费。
当前订阅: 最新报告的订阅状态为有效。

依据购买记录回答订阅问题。

什么是 App Store Server API AI 智能体？

App Store AI 智能体可以根据客户的购买历史与订阅记录整理客服摘要，不改变订阅。

你指定资料来源和保存位置。Leina 使用连接有权访问的内容完成任务，再把结果交给你检查。

App Store Server API

App Store Server API 为应用团队提供购买与订阅记录。

指定购买记录
提供该客户在此应用中的交易编号。
核对历史
读取购买与订阅记录。
准备回复
整理供客服使用的状态说明。

可以交给 Leina 的 App Store Server API 任务

复制示例，补充具体信息，然后在已接入的团队聊天中发给 Leina。

解读客户购买历史

查看交易 [交易编号] 的购买历史和订阅状态，整理客服摘要，不改变订阅。

app_store_server

调查通知投递

查看 [时间范围] 的 App Store 通知及投递失败记录，按通知类型汇总问题。

app_store_server

下一项 App Store Server API 工作，从一条消息开始。

开始使用

连接工具，交代任务，查看结果

在团队聊天中告诉 Leina 你的需求，说明数据来源、保存位置和预期结果。

连接账号

连接任务涉及的工具，让 Leina 访问需要的内容。
尝试一个任务

提供资料来源、结果的保存位置，以及你希望完成的工作。
核对结果

查看任务结果，并核对应用中的变更。

让 Leina 在 App Store Server API 中动手完成工作

把这些日常工作交给你的 AI 员工。

Get Transaction History

列出某位客户在你的 App 中的内购交易，默认最旧的在前，从 Apple 返回的 JWS 签名负载解码而来。把 sort 设为 DESCENDING 可让最新的交易排在前面。每页最多返回 20 条交易。

Get Transaction Info

按标识符读取单条内购交易，从 Apple 返回的 JWS 签名负载解码而来。

Get App Transaction Info

读取某位客户的应用下载交易，由 Apple 返回的 JWS 签名负载解码得到。它记录客户首次获取该应用的时间以及所在平台。

Look Up Order Id

根据客户 App Store 收据中的订单 ID 查询其背后的内购交易，用于确认该订单真实有效且属于你的 App。Apple 只在生产环境提供该端点，因此在 sandbox 连接上调用会失败。

Set App Account Token

为某笔交易设置或替换 app account token，从而把在你的 App 之外完成的购买与你自有服务中的客户关联起来。会覆盖已设置的 token。

Finish Transaction

告知 App Store 你的服务器已完成某笔交易的内容交付。仅在客户已获得内容后调用；该操作不可撤销。已完结的交易仍会出现在 get_transaction_history 的结果中，因此不要把它从历史中消失当作确认。

Get All Subscription Statuses

读取客户在你的 App 中每个自动续期订阅的状态，按订阅组分组，并从 Apple 返回的 JWS 签名负载中解码出各项订阅的最新交易和续期信息。

Extend Subscription Renewal Date

延长某位客户当前有效的自动续期订阅的续期日期，用于补偿服务中断或活动取消。该延期无法回退，Apple 会就新的续期日期向客户发送邮件。

Extend Renewal Date For All Active Subscribers

延长某个产品下所有有效订阅的续期日期，可选择只对部分店面生效。App Store 会异步处理该请求，请轮询 get_subscription_renewal_date_extension_status 获取结果。该延期无法撤回。

Get Subscription Renewal Date Extension Status

查询 App Store 对某个产品全部有效订阅者发起的续期日期延长请求的处理进度。

Get Refund History

列出 App Store 为你的 app 中某个客户退款的内购交易，按时间从新到旧排列，由 Apple 返回的 JWS 签名负载解码得到。每页最多返回 20 笔交易。

Send Consumption Information

在收到 CONSUMPTION_REQUEST 通知后发送某笔内购的消耗信息，以便 App Store 对客户的退款请求作出裁定。Apple 要求在收到通知后 12 小时内作出响应。适用于不经过 Advanced Commerce API 的 App Store 内购。

Send Consumption Information V1

在收到 CONSUMPTION_REQUEST 通知后，为某笔内购发送第 1 版消耗信息。Apple 记录的这一结构适用于通过 Advanced Commerce API 完成的购买；普通的 App Store 内购请使用 send_consumption_information。

Request Test Notification

请求 App Store 向你为应用配置的 App Store Server Notifications URL 发送一条 TEST 通知，并返回标识本次尝试的令牌。若所选环境没有配置通知 URL，调用会失败。

Get Test Notification Status

读取测试通知的投递结果，并从 Apple 返回的 JWS 签名负载中解码出通知负载。在 Apple 完成首次投递尝试之前，会返回 404。

Get Notification History

列出某个时间范围内 App Store 尝试向你的服务器投递的 App Store Server Notifications，并对每条通知负载进行解码。历史记录在生产环境覆盖过去 180 天，在沙盒覆盖过去 30 天，每页最多返回 20 条记录。

Upload Retention Image

为挽留信息上传一张 PNG 图片：FULL_SIZE 图片显示在信息正文上方，BULLET_POINT 图片用作要点图标。图片上传后处于 PENDING 状态，需经 Apple 审核后才能展示；可用 get_retention_image_list 查看状态。每个 App 最多保存 2000 张图片，同一个标识符只能上传一次。只有处于 APPROVED 状态的图片和文案才会展示给用户；沙盒环境会立即批准上传内容。Retention Messaging API 的访问权限由 Apple 按开发者账号授予；未开通时这些端点会返回不带错误体的 404。

Get Retention Image List

列出本连接对应 App 和环境下为挽留信息上传的所有图片，包括用途和审核状态。只有处于 APPROVED 状态的图片和文案才会展示给用户；沙盒环境会立即批准上传内容。Retention Messaging API 的访问权限由 Apple 按开发者账号授予；未开通时这些端点会返回不带错误体的 404。

Delete Retention Image

删除一张已上传的挽留图片。若仍有文案引用该图片，Apple 会以 403 拒绝，请先删除文案；图片不存在时返回 404。Retention Messaging API 的访问权限由 Apple 按开发者账号授予；未开通时这些端点会返回不带错误体的 404。

Upload Retention Message

上传一条挽留信息的文案：标题、正文，可选一张全尺寸图片以及带图标的要点列表。文案上传后处于 PENDING 状态，需经 Apple 审核；可用 get_retention_message_list 查看状态。计划用作换档方案或促销优惠信息的文案不要带 image 和 bulletPoints。每个 App 最多保存 2000 条文案，同一个标识符只能上传一次。只有处于 APPROVED 状态的图片和文案才会展示给用户；沙盒环境会立即批准上传内容。Retention Messaging API 的访问权限由 Apple 按开发者账号授予；未开通时这些端点会返回不带错误体的 404。

Get Retention Message List

列出本连接对应 App 和环境下为挽留信息上传的所有文案及其审核状态。带图片的文案还要求图片处于 APPROVED 状态，可用 get_retention_image_list 查看。Retention Messaging API 的访问权限由 Apple 按开发者账号授予；未开通时这些端点会返回不带错误体的 404。

Delete Retention Message

删除一条已上传的挽留文案。文案不存在时返回 404。请先让你的 Get Retention Message 端点不再返回该标识符，之后再用 delete_retention_image 删除它用到的图片。Retention Messaging API 的访问权限由 Apple 按开发者账号授予；未开通时这些端点会返回不带错误体的 404。

Configure Default Retention Message

设置 App Store 为某个订阅产品在某个 locale 下展示的默认挽留信息，并替换之前配置的默认信息。只有纯文本或带图片的文本类文案可以作为默认信息，且文案及其图片都必须处于 APPROVED 状态。产品在某个 locale 下没有默认信息时，该 locale 不会展示任何挽留信息；默认信息同时也是你的实时端点失败时的兜底。Retention Messaging API 的访问权限由 Apple 按开发者账号授予；未开通时这些端点会返回不带错误体的 404。

Get Default Retention Message

读取某个订阅产品在某个 locale 下配置为默认挽留信息的文案。未配置默认信息时 messageIdentifier 为 null。Retention Messaging API 的访问权限由 Apple 按开发者账号授予；未开通时这些端点会返回不带错误体的 404。

Delete Default Retention Message

移除某个订阅产品在某个 locale 下的默认挽留信息，之后 App Store 在该处不再展示挽留信息。即使原本没有配置默认信息也会成功。Retention Messaging API 的访问权限由 Apple 按开发者账号授予；未开通时这些端点会返回不带错误体的 404。

Configure Retention Realtime Url

为本连接所在环境注册你的 Get Retention Message 端点 URL，并替换之前注册的 URL。设置后，每当订阅者进入取消流程，App Store 都会调用该端点并展示你选择的信息。生产环境的 URL 只有在你的端点通过沙盒性能测试后才会被接受 (否则 Apple 返回 403)。Retention Messaging API 的访问权限由 Apple 按开发者账号授予；未开通时这些端点会返回不带错误体的 404。

Get Retention Realtime Url

读取本连接所在环境注册的 Get Retention Message 端点 URL。未注册时 realtimeUrl 为 null。Retention Messaging API 的访问权限由 Apple 按开发者账号授予；未开通时这些端点会返回不带错误体的 404。

Delete Retention Realtime Url

注销本连接所在环境的 Get Retention Message 端点 URL。之后在该环境中 App Store 只展示默认信息，直到重新注册 URL。Retention Messaging API 的访问权限由 Apple 按开发者账号授予；未开通时这些端点会返回不带错误体的 404。

Initiate Retention Performance Test

启动 Apple 对沙盒中已注册的 Get Retention Message 端点的性能测试，以一个有效的沙盒订阅作为样本购买。只有通过该测试，configure_retention_realtime_url 才会接受生产环境的 URL。返回请求标识符和测试参数；测试会持续返回的 totalDuration 时长。仅在 environment 为 sandbox 的连接上可用；Apple 只在沙盒主机上提供性能测试端点。Retention Messaging API 的访问权限由 Apple 按开发者账号授予；未开通时这些端点会返回不带错误体的 404。

Get Retention Performance Test Results

读取由 initiate_retention_performance_test 启动的沙盒性能测试结果：测试进行中为 PENDING，之后为 PASS 或 FAIL，并附带测得的响应时间、成功率和失败计数。仅在 environment 为 sandbox 的连接上可用；Apple 只在沙盒主机上提供性能测试端点。Retention Messaging API 的访问权限由 Apple 按开发者账号授予；未开通时这些端点会返回不带错误体的 404。