如何解决 Landsatxplore API 报错：usgserror not_found invalid endpoint？

Question

在使用Landsatxplore API时，如果遇到“usgserror not_found invalid endpoint”报错，通常是因为请求的API端点地址不正确或已更改。首先，确认是否使用了最新的API文档中规定的端点URL。例如，确保将请求发送到正确的地址，如`https://api.landsatxplore.usgs.gov/`，而不是过期或错误的链接。 其次，检查API调用中的参数是否完整且符合要求，包括必需的`sceneID`、`apiKey`等字段。此外，确认API密钥的有效性及权限范围，必要时重新生成或联系管理员更新。 最后，建议启用详细的日志记录功能，捕获完整的请求与响应信息以定位问题。若仍无法解决，可参考USGS官方论坛或社区支持，获取最新解决方案和变更通知。保持API客户端库版本为最新也有助于避免类似问题。

Answer 1

1. 理解问题：API端点错误的基本概念

在使用Landsatxplore API时，如果遇到“usgserror not_found invalid endpoint”报错，这通常表明客户端尝试访问的API端点地址不正确或已更改。以下是一个简单的示例代码片段，展示如何构造一个基本的API请求：

import requests

url = "https://api.landsatxplore.usgs.gov/"  # 正确的API端点
params = {
    "sceneID": "LC80140332017156LGN00",
    "apiKey": "your_api_key_here"
}
response = requests.get(url, params=params)
print(response.text)

确保将请求发送到正确的地址，如`https://api.landsatxplore.usgs.gov/`，而不是过期或错误的链接。

2. 深入分析：参数与密钥的有效性检查

除了确认API端点的正确性，还需要检查API调用中的参数是否完整且符合要求。以下是需要验证的关键点：

• 确保`sceneID`字段填写的是有效的场景标识符。
• 验证`apiKey`字段是否为当前有效的API密钥。
• 检查API密钥的权限范围，确保其支持所需的API操作。

如果发现API密钥无效或权限不足，建议重新生成新的密钥，或者联系系统管理员进行更新。

3. 高级定位：启用日志记录与版本控制

为了更精确地定位问题，建议启用详细的日志记录功能。通过捕获完整的请求与响应信息，可以快速识别潜在的问题。以下是一个日志记录的示例配置：

import logging

logging.basicConfig(level=logging.DEBUG)
logger = logging.getLogger(__name__)

try:
    response = requests.get(url, params=params)
    logger.debug(f"Request URL: {response.url}")
    logger.debug(f"Response Status: {response.status_code}")
    logger.debug(f"Response Body: {response.text}")
except Exception as e:
    logger.error(f"An error occurred: {e}")

此外，保持API客户端库版本为最新也有助于避免类似问题。可以通过以下命令检查并升级Python的requests库：

pip install --upgrade requests

4. 社区支持与变更通知

若上述方法仍无法解决问题，可参考USGS官方论坛或社区支持。以下是问题排查流程图，帮助您系统化地解决该类问题：

graph TD;
    A[确认API端点] --> B{端点是否正确};
    B --是--> C[检查API参数];
    B --否--> D[更新API文档];
    C --> E{参数是否完整};
    E --是--> F[验证API密钥];
    E --否--> G[补充缺失参数];
    F --> H{密钥是否有效};
    H --是--> I[启用日志记录];
    H --否--> J[重新生成密钥];

通过以上步骤，您可以逐步缩小问题范围，并最终找到解决方案。