travel-promos-argentina

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Travel Promos Argentina

阿根廷旅行促销信息

Consulta promociones de viajes (vuelos, hoteles y paquetes) y permite filtrarlas y ordenarlas localmente.

查询旅行促销信息（航班、酒店及套餐），并支持本地筛选和排序。

API Overview

API概述

Base URL:
```
https://anduin.ferminrp.workers.dev
```
Auth: None required
Response format: JSON
Endpoint principal:
```
/api/v1/promos
```
Fuente upstream:
```
data.source
```
Timestamps relevantes:
- ```
data.lastUpdated
```
  (actualizacion de promos)
- ```
timestamp
```
  (respuesta del servicio)
Nota: los query params probados (
```
category
```
,
```
destinationCountry
```
,
```
limit
```
,
```
q
```
) no filtran en origen; filtrar localmente con
```
jq
```
.

基础URL：
```
https://anduin.ferminrp.workers.dev
```
认证：无需认证
响应格式：JSON
主端点：
```
/api/v1/promos
```
上游数据源：
```
data.source
```
相关时间戳:
- ```
data.lastUpdated
```
  （促销信息更新时间）
- ```
timestamp
```
  （服务响应时间）
注意：已测试的查询参数（
```
category
```
、
```
destinationCountry
```
、
```
limit
```
、
```
q
```
）不会在数据源端进行筛选；需使用
```
jq
```
在本地完成筛选。

Endpoint

端点

```
GET /api/v1/promos
```

Ejemplos de uso:

bash

curl -s "https://anduin.ferminrp.workers.dev/api/v1/promos" | jq '.'
curl -s "https://anduin.ferminrp.workers.dev/api/v1/promos" | jq '.data.promos[0:5]'
curl -s "https://anduin.ferminrp.workers.dev/api/v1/promos" | jq '.data.promos | map(select(.category == "vuelos"))'
curl -s "https://anduin.ferminrp.workers.dev/api/v1/promos" | jq '.data.promos | map(select(.destinationCountry == "brazil"))'
curl -s "https://anduin.ferminrp.workers.dev/api/v1/promos" | jq '.data.promos | sort_by(-.score) | .[0:10]'

```
GET /api/v1/promos
```

使用示例：

bash

curl -s "https://anduin.ferminrp.workers.dev/api/v1/promos" | jq '.'
curl -s "https://anduin.ferminrp.workers.dev/api/v1/promos" | jq '.data.promos[0:5]'
curl -s "https://anduin.ferminrp.workers.dev/api/v1/promos" | jq '.data.promos | map(select(.category == "vuelos"))'
curl -s "https://anduin.ferminrp.workers.dev/api/v1/promos" | jq '.data.promos | map(select(.destinationCountry == "brazil"))'
curl -s "https://anduin.ferminrp.workers.dev/api/v1/promos" | jq '.data.promos | sort_by(-.score) | .[0:10]'

Campos clave

核心字段

Top-level:
- ```
success
```
  (bool)
- ```
timestamp
```
  (ISO datetime)
```
data
```
:
- ```
lastUpdated
```
  (ISO datetime)
- ```
source
```
  (URL de origen)
- ```
totalPromos
```
  (int)
- ```
promos
```
  (array)

promos[]

```
id
```
,
```
date
```
,
```
title
```
,
```
link
```
,
```
permalink
```
,
```
thumbnailUrl
```
```
destinationCountry
```
(puede ser
```
null
```
)
```
category
```
```
score
```
(numerico para ranking)

Valores dinamicos observados hoy (ejemplos, no lista cerrada):

```
category
```
:
```
vuelos
```
,
```
hoteles
```
,
```
paquetes
```
,
```
otros
```

destinationCountry

brazil

united_states

spain

dominican_republic

aruba

south_africa

null

顶层字段:
- ```
success
```
  （布尔值）
- ```
timestamp
```
  （ISO格式时间）
```
data
```
字段:
- ```
lastUpdated
```
  （ISO格式时间）
- ```
source
```
  （数据源URL）
- ```
totalPromos
```
  （整数，促销总数）
- ```
promos
```
  （数组，促销列表）

promos[]

数组元素:

```
id
```
,
```
date
```
,
```
title
```
,
```
link
```
,
```
permalink
```
,
```
thumbnailUrl
```
```
destinationCountry
```
（可能为
```
null
```
）
```
category
```
（分类）
```
score
```
（用于排名的数值）

当前观测到的动态值（示例，非完整列表）:

```
category
```
:
```
vuelos
```
,
```
hoteles
```
,
```
paquetes
```
,
```
otros
```

destinationCountry

brazil

united_states

spain

dominican_republic

aruba

south_africa

null

Workflow

工作流程

Detectar intencion del usuario:
- Listado general
- Filtro por categoria o pais
- Ranking por score
- Ultimas promos
Consultar endpoint unico con
```
curl -s
```
.
Validar
```
success == true
```
y existencia de
```
data.promos
```
.
Aplicar filtros y orden localmente con
```
jq
```
:
- Por
```
category
```
- Por
```
destinationCountry
```
- Por
```
date
```
  o
```
score
```
Responder primero con snapshot:
- Cantidad total (
```
totalPromos
```
  )
- ```
lastUpdated
```
- Top 3 promos por score o relevancia

Luego mostrar tabla corta (top 5/10):

date | category | destinationCountry | score | title

Incluir links (
```
link
```
o
```
permalink
```
) solo para promos mostradas.
Mantener respuesta informativa, sin consejos financieros ni garantias de disponibilidad.

识别用户意图:
- 通用列表查询
- 按分类或国家筛选
- 按评分排名
- 最新促销信息
使用
```
curl -s
```
调用唯一端点。
验证
```
success == true
```
且
```
data.promos
```
存在。
使用
```
jq
```
在本地应用筛选和排序:
- 按
```
category
```
  筛选
- 按
```
destinationCountry
```
  筛选
- 按
```
date
```
  或
```
score
```
  排序
首先返回快照信息:
- 促销总数（
```
totalPromos
```
  ）
- ```
lastUpdated
```
  （更新时间）
- 按评分或相关性排序的前3条促销

随后展示简短表格（前5/10条）:

date | category | destinationCountry | score | title

仅为展示的促销信息添加链接（
```
link
```
或
```
permalink
```
）。
保持回复内容信息详实，不提供财务建议或可用性保证。

Error Handling

错误处理

HTTP no exitoso:
- Informar codigo HTTP y endpoint consultado.
success: false
:
- Mostrar payload de error si existe.
JSON inesperado:
- Mostrar minimo crudo util y aclarar inconsistencia.
Red o timeout:
- Reintentar hasta 2 veces con espera corta.
promos
vacio:
- Informar "no hay promociones disponibles actualmente".

HTTP请求失败:
- 告知用户HTTP状态码及查询的端点。
success: false
:
- 若存在错误负载则展示该内容。
意外JSON格式:
- 展示最少可用的原始内容，并说明数据存在不一致性。
网络问题或超时:
- 最多重试2次，每次间隔短时间等待。
promos
数组为空:
- 告知用户“当前无可用促销信息”。

Presenting Results

结果展示

Formato por defecto:
- Resumen ejecutivo + tabla corta
Priorizar:
- Recencia (
```
date
```
  )
- Relevancia (
```
score
```
  )
- Claridad de destino y categoria
Aclarar timestamps (
```
lastUpdated
```
y/o
```
timestamp
```
) y la fuente externa (
```
data.source
```
).
No emitir recomendaciones de compra; solo informar promociones disponibles.

默认格式:
- 执行摘要 + 简短表格
优先级排序:
- 时效性（
```
date
```
  ）
- 相关性（
```
score
```
  ）
- 目的地和分类的清晰度
需说明时间戳（
```
lastUpdated
```
和/或
```
timestamp
```
）及外部数据源（
```
data.source
```
）。
不得提供购买建议；仅告知可用的促销信息。

Out of Scope

超出范围内容

Esta skill no debe hacer en v1:

Scraping directo de sitios externos
Automatizacion de reserva o compra
Alertas push, notificaciones o tracking de cambios
Uso de endpoints distintos de
```
/api/v1/promos
```

本技能V1版本不支持以下功能：

直接爬取外部网站数据
自动预订或购买
推送提醒、通知或变更追踪
使用
```
/api/v1/promos
```
以外的端点