App Store Connect API 报错：'app' relationship 不存在？解决方案详解

2024-10-03 04:08:35

在使用 App Store Connect API 获取应用信息时，你可能会遇到 "The relationship 'app' does not exist on resource 'bundleIds'" 这个错误。这个错误提示意味着 API 找不到与你提供的 Bundle ID 关联的应用信息。你可能很疑惑，明明应用在 App Store 上存在，为什么 API 却找不到呢？

这其实是由于 App Store Connect API 的数据结构导致的。Bundle ID 和 App 在 API 中是两个独立的实体，它们之间存在关联关系，但不是简单的一对一关系。一个 Bundle ID 可以对应多个 App，比如同一个应用的不同版本（免费版和付费版），或者同一个开发者账户下的不同应用。

App Store Connect API 的设计是，你需要先获取 Bundle ID 的信息，然后通过 Bundle ID 信息中的关联关系找到对应的 App 信息。API 不会直接通过 Bundle ID 提供 App 信息，你需要找到连接它们的桥梁。

如何解决这个问题呢？

你需要先获取 Bundle ID 的详细信息，然后从中找到 App 的关联信息，具体步骤如下：

1. 获取 Bundle ID 信息

使用 App Store Connect API 获取 Bundle ID 的详细信息，可以使用以下 API 端点：

https://api.appstoreconnect.apple.com/v1/bundleIds/{id}

注意：你需要将 {id} 替换为你的 Bundle ID 的 ID，而不是 Bundle ID 字符串。

2. 解析 Bundle ID 信息

API 返回的 Bundle ID 信息是一个 JSON 对象，包含了 Bundle ID 的各种属性，包括与之关联的 App 信息。你需要解析这个 JSON 对象，找到名为 relationships 的字段。

在 relationships 字段中，你会找到一个名为 app 的字段。这个字段包含了与该 Bundle ID 关联的 App 的信息，包括 App 的 ID 和一些基本信息。

3. 获取 App 信息

现在你已经获得了 App 的 ID，可以使用以下 API 端点获取 App 的详细信息：

https://api.appstoreconnect.apple.com/v1/apps/{id}

将 {id} 替换为你在上一步中获取到的 App ID。

代码示例 (Python)

下面是一个使用 Python 代码演示如何获取 App 信息的示例：

import requests
import jwt

# App Store Connect API 密钥信息
KEY_ID = "YOUR_KEY_ID"
ISSUER_ID = "YOUR_ISSUER_ID"
PRIVATE_KEY_PATH = "path/to/your/AuthKey_XXXXXX.p8"

# Bundle ID
BUNDLE_ID = "com.example.app"

# 生成 JWT 令牌
def generate_jwt_token():
    with open(PRIVATE_KEY_PATH, 'r') as f:
        private_key = f.read()
    
    payload = {
        "iss": ISSUER_ID,
        "exp": int(time.time()) + 20 * 60,  # Token 有效期 20 分钟
        "aud": "appstoreconnect-v1"
    }
    
    token = jwt.encode(payload, private_key, algorithm="ES256", headers={"kid": KEY_ID})
    return token

# 获取 Bundle ID 信息
def get_bundle_id_info(bundle_id_id):
    token = generate_jwt_token()
    headers = {
        "Authorization": f"Bearer {token}"
    }
    url = f"https://api.appstoreconnect.apple.com/v1/bundleIds/{bundle_id_id}"
    response = requests.get(url, headers=headers)
    return response.json()

# 获取 App 信息
def get_app_info(app_id):
    token = generate_jwt_token()
    headers = {
        "Authorization": f"Bearer {token}"
    }
    url = f"https://api.appstoreconnect.apple.com/v1/apps/{app_id}"
    response = requests.get(url, headers=headers)
    return response.json()

# 获取 Bundle ID ID (假设你已经知道 Bundle ID 字符串)
# ... (省略获取 Bundle ID ID 的代码，可以使用 /v1/bundleIds 端点搜索) ...

# 获取 Bundle ID 信息
bundle_id_info = get_bundle_id_info(bundle_id_id)

# 获取 App ID
app_id = bundle_id_info["relationships"]["app"]["data"]["id"]

# 获取 App 信息
app_info = get_app_info(app_id)

# 打印 App 信息
print(app_info)