@haatlabs-core/服务
Haatlabs API在RapidAPI上的客户端:亚马逊搜索和产品页面,图像搜索, 背景去除,AI产品描述和图像检查,以及链接它们的工作. 一个 RapidAPI密钥;工作运行在Haatlabs的服务器上.
安装
pnpm add @haatlabs-core/services
在 RapidAPI 上订阅 Haatlabs API( BASIC 计划是免费的) , 并将密钥放入您的应用程序
环境 HAATLABS_API_KEY计划和限制: https://haatlabs.shop/docs/服务/
使用
import { createHaatlabsApi } from '@haatlabs-core/services';
const api = createHaatlabsApi({ apiKey: process.env.HAATLABS_API_KEY! });
const page = await api.amazon.search({ q: 'desk lamp', market: 'US' });
const cutout = await api.images.removeBackground({ image: bytes }); // or { imageUrl }
const job = await api.jobs.start('find-clean', { query: 'desk lamp', limit: 5 });
const done = await api.jobs.wait(job.jobId);
amazon.search(query), (中文(简体) ),amazon.product({ market, id })images.search(q, { limit }), (中文(简体) ),images.removeBackground({ image } | { imageUrl }): 图像 以字节表示( 最多 5 MB,MAX_UPLOAD_BYTES)或公众 https URL;断开的 URL 是 签名直到expiresAt。 。 。 .ai.describe({ product, tone, language, keywords }), (中文(简体) ),ai.vision({ image } | { imageUrl }, expect, minMatch): 图像及其verdict。 。 。 .jobs.start(kind, body)页:1enrich, (中文(简体) ),find-clean, (中文(简体) ),listing, (中文(简体) ),find-checked财务报告和审定财务报表pipeline· ;jobs.get(id)· ;jobs.wait(id, { intervalMs, timeoutMs })。 。 。 .verifyWebhook({ secret, headers, body }): 工作召回是否真的是API的 (标准Webhooks签名, 5分钟左右). 传出生身.
选项 : host (上市的RapidAPI主机), baseUrl, (中文(简体) ), fetch, (中文(简体) ), timeoutMs (35s) (英语).
错误
每一次失败都是一次 AppError (单位:千美元)@haatlabs-core/errors); 项目扩展 SERVICES_ERRORS 输入
defineErrorsA级 ServiceError 也携带API的自带 serviceCode 财务报告和审定财务报表 requestId。 。 。 .
SERVICE_QUOTA_EXCEEDED(503年):计划定额用完;升级或等期.SERVICE_RATE_LIMITED(503,瞬间):太多人要求一秒.SERVICE_KEY_REFUSED(503):错误的密钥,或未订阅API.SERVICE_REQUEST_REJECTED(422):API拒绝发送的(422)IMAGE_REJECTED, (中文(简体) ),PIPELINE_INVALID(三);VALIDATION_FAILED(400个)和NOT_FOUND(404)通过.SERVICE_UNAVAILABLE(503):API或其背后的服务是离家出走或繁忙(短暂),或 回答一些无法使用( 不是瞬间) .SERVICE_JOB_TIMEOUT(503,瞬间):jobs.wait在工作结束前停了下来.
拒绝使用超过 5 MB 的图像 VALIDATION_FAILED 在发送任何信息之前.
测试
@haatlabs-core/services/testing 已经 startFakeApi()一个像API这样的本地站点
也喜欢RapidAPI的拒绝(refuse('quota'), (中文(简体) ), failNext(path, status, code), (中文(简体) ),
jobsNeverFinish()记录每个请求. pnpm test:real 做一个直播每
方法为 HAATLABS_API_KEY。 。 。 .