Hacker News API -- OpenAPI Spec

Simple OpenAPI spec for the HN API to do strongly typed code generation off of.

Spec: https://raw.githubusercontent.com/andenacitelli/hacker-news-api-openapi/main/exports/api.yaml

• Based off the original API here: https://github.com/HackerNews/API
• Built with zod schemas and exported to OpenAPI via @asteasolutions/zod-to-openapi. Refreshes every commit via a pre-commit hook.
• End spec validated with Redocly CLI
• Schemas validated by making a real call to HN for each endpoint and ensuring the schema validates w/o failure

Contributing

Please raise issues and I'm happy to fix.

Funding

If you appreciate the work I do, please feel free to buy me a coffee through GitHub Sponsors or Ko-Fi.

License

MIT