使用 ShipEngine 跟踪配送标签
Made by ShipEngine
提供一个可调用的 https 函数来检索标签跟踪数据,并提供一个 https webhook 端点来实时跟踪来自 ShipEngine 帐号的更新。
此扩展程序的运作方式
使用此扩展程序,通过有效的跟踪编号和受支持的运输公司代码或 ShipEngine 标签 ID 检索任何运输公司任何发货的最新跟踪数据。
下面是将触发此扩展程序的函数调用示例:
import { initializeApp } from 'firebase/app'; import { getFunctions, httpsCallable } from 'firebase/functions'; const app = initializeApp({ projectId: '### CLOUD FUNCTIONS PROJECT ID ###', apiKey: '### FIREBASE API KEY ###', authDomain: '### FIREBASE AUTH DOMAIN ###', }); const functions = getFunctions(app); const trackLabel = httpsCallable(functions, 'trackLabel'); trackLabel({ trackingNumber: '9405511899223197428490', carrierCode: 'stamps_com', }).then((result) => { // Read result of the Cloud Function. /** @type {any} */ const data = result.data; });
额外设置
在安装此扩展程序之前,请确保您已经在 Firebase 项目中设置了一个 Cloud Firestore 数据库。
在配置此扩展程序时,您还必须创建一个 ShipEngine 帐号或使用您的现有帐号,并从 ShipEngine API 管理页面提供您的 ShipEngine API 密钥。
结算
若要安装扩展程序,您的项目必须采用 Blaze(随用随付)方案
- 您需要为此扩展程序所需的 Firebase 资源支付少量费用(通常约为 $0.01/月),即使没有使用此扩展程序也要支付。
- 此扩展程序用到了其他 Firebase 和 Google Cloud Platform 服务,如果超出这些服务的免费层级,则会产生相关费用:
- Cloud Firestore
- Cloud Functions(Node.js 15+ 运行时。查看常见问题解答)
- Cloud Secret Manager
使用此扩展程序还需要您拥有 ShipEngine 帐号。您需要自行承担与使用 ShipEngine 帐号相关的任何费用。
如何安装此扩展程序
使用 Firebase CLI
要安装和管理扩展程序,您还可以使用 Firebase CLI:
步骤 1:运行以下 npm 命令来安装 CLI 或将 CLI 更新到最新版本。
npm install -g firebase-tools不能运行?请参阅 Firebase CLI 参考文档或者更改您的 npm 权限。
第 2 步:设置一个新的 Firebase 项目目录或转到现有目录
第 3 步:将此扩展程序添加到扩展程序清单中
firebase ext:install shipengine/track-labels --local --project=projectId_or_alias
第 4 步(可选):使用 Firebase Emulator Suite 在本地测试此扩展程序
firebase emulators:start
第 5 步:将清单中的扩展程序部署到项目中
firebase deploy --only extensions --project=projectId_or_alias