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.

Источник