Two tools built on our data, and what our docs left out

说明与用途

开发者基于 Pulsed Media 的公开数据构建工具，但因文档缺失字段说明导致误解。通过澄清字段类型和含义，工具修正了错误并使用 ETag 与时间戳检查优化了轮询效率。

问题

Developers built tools on Pulsed Media’s public data feeds but encountered undocumented field semantics, leading to incorrect interpretations and UI errors.

结果

Tools now correctly interpret feed data, reducing UI errors and bandwidth waste. Conditional polling aligns with feed rebuild rate, improving efficiency.

工作流

• 1. Identify undocumented fields in feeds.
• 2. Analyze tool behavior and errors.
• 3. Update documentation to specify field types and semantics.
• 4. Modify tools to parse floats, handle nulls, and respect 'available' flag.
• 5. Adjust price comparison logic to account for base vs. starting prices.
• 6. Implement conditional GETs using ETag/Last-Modified.
• 7. Add timestamp validation and polling rate alignment.
• 8. Test changes against real feed data.

证据

A float that is usually whole.

来源

Negative stock.

来源

Stock that isn't sent.

来源

Products with no monthly price.

来源

Two prices for one product.

来源

PulseWatch fetches the catalog every five minutes. Our product feed is rebuilt every 15 minutes...

来源

Check the timestamp, not just the status code.

来源