LittleMissSomething

Developer resources

LittleMissSomething developer resources

This page documents the machine-readable surface of LittleMissSomething, a handmade hair accessories shop. Everything listed here is real and fetchable today. The only write flow is the shopper checkout in the browser; every other interface on this page is read-only.

Content guides for agents

  • llms.txt is a curated index of the shop with ordering facts, shipping facts, and when to use this site.
  • llms-full.txt is the longer single-file reference with the same facts plus catalog and policy pointers.
  • sitemap.xml lists the homepage, shop, story, contact, privacy, developer resources, and every product page.
  • robots.txt allows AI answer engines including GPTBot, ClaudeBot, PerplexityBot, and Google-Extended across public pages.

Product catalog API

The public read API is JSON over HTTPS with no authentication. It is rate friendly for catalog reads and returns structured JSON errors with an error code and message.

  • GET /api/products lists products, with optional featured=1, categoryId, and q filters.
  • GET /api/products/[slug] returns one product by its URL slug, or a JSON 404 with code NOT_FOUND.
  • GET /api/v1/status is a tiny public health endpoint agents can use to confirm the API is up.
  • Unknown /api/* paths return a structured JSON 404 rather than an HTML page.

Machine descriptions: openapi.json (OpenAPI 3.1 for the public read API) and /.well-known/api-catalog (RFC 9727 catalog pointing at the OpenAPI file). Versioning: the current major version is v1 in the URL path. Breaking changes will ship under a new version path, and any deprecation will be announced here and in the OpenAPI description before old behavior is removed. The same docs also live at the predictable aliases /developers, /docs, and /api-docs.

Markdown negotiation

The homepage, shop, story, contact, privacy, developer resources, and product pages serve text/markdown when the request Accept header prefers it, with Vary: Accept. Missing pages return a real HTTP 404 with recovery links, and the same 404 is available as markdown when requested. Product data itself is cleanest from the JSON API or the server-rendered HTML.

Start here

Read the homepage, browse the full catalog, learn our story, or contact the shop. Ordering is UPI only to littlemisssomething@upi with manual verification, Rs. 99 shipping, and free shipping over Rs. 999.