{"openapi":"3.1.0","info":{"title":"Dharma Rocks API","version":"1.0.0","description":"A read-only public API for approved Dharma Rocks content: chapters, stories, gallery photos, and tracked rocks with their journeys. No authentication required. Only public, moderated content is exposed - no personal data.","license":{"name":"CC BY 4.0","url":"https://creativecommons.org/licenses/by/4.0/"}},"servers":[{"url":"https://dharma-rocks.com/api/v1","description":"This site"}],"paths":{"/chapters":{"get":{"tags":["Chapters"],"summary":"List chapters","description":"Every approved local Dharma Rocks group.","operationId":"listChapters","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChapterList"}}}}}}},"/chapters/{slug}":{"get":{"tags":["Chapters"],"summary":"Get a chapter","description":"A single approved chapter by its slug.","operationId":"getChapter","parameters":[{"name":"slug","in":"path","required":true,"description":"The chapter's URL slug.","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Chapter"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/stories":{"get":{"tags":["Stories"],"summary":"List stories","description":"Every published story.","operationId":"listStories","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StoryList"}}}}}}},"/stories/{id}":{"get":{"tags":["Stories"],"summary":"Get a story","description":"A single published story by its id.","operationId":"getStory","parameters":[{"name":"id","in":"path","required":true,"description":"The story id.","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Story"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/gallery":{"get":{"tags":["Gallery"],"summary":"List gallery photos","description":"Every published photo of a painted rock.","operationId":"listGallery","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GalleryList"}}}}}}},"/rocks":{"get":{"tags":["Rocks"],"summary":"List rocks","description":"Every approved rock that can be tracked.","operationId":"listRocks","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RockList"}}}}}}},"/rocks/{code}":{"get":{"tags":["Rocks"],"summary":"Get a rock and its journey","description":"A single rock by its public code, including its journey (sightings) and any linked stories.","operationId":"getRock","parameters":[{"name":"code","in":"path","required":true,"description":"The rock's public code, e.g. DR-RIVER.","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RockDetail"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"Chapter":{"$id":"#/components/schemas/Chapter","type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"town":{"anyOf":[{"type":"string"},{"type":"null"}]},"region":{"anyOf":[{"type":"string"},{"type":"null"}]},"country":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"type":"string"},"approxLat":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Approximate latitude (rounded for privacy), or null"},"approxLng":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Approximate longitude (rounded for privacy), or null"},"leadDisplayName":{"anyOf":[{"type":"string"},{"type":"null"}]},"memberCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"rocksHidden":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"string","description":"ISO 8601 timestamp"}},"required":["slug","name","town","region","country","description","approxLat","approxLng","leadDisplayName","memberCount","rocksHidden","createdAt"],"additionalProperties":false},"Story":{"$id":"#/components/schemas/Story","type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"body":{"type":"string"},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"imageAlt":{"anyOf":[{"type":"string"},{"type":"null"}]},"authorDisplayName":{"type":"string"},"rockCode":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Public code of the rock this story is about, if any"},"publishedAt":{"anyOf":[{"type":"string","description":"ISO 8601 timestamp"},{"type":"null"}]}},"required":["id","title","body","imageUrl","imageAlt","authorDisplayName","rockCode","publishedAt"],"additionalProperties":false},"GalleryItem":{"$id":"#/components/schemas/GalleryItem","type":"object","properties":{"id":{"type":"string"},"imageUrl":{"type":"string"},"altText":{"type":"string"},"caption":{"anyOf":[{"type":"string"},{"type":"null"}]},"authorDisplayName":{"type":"string"},"createdAt":{"type":"string","description":"ISO 8601 timestamp"}},"required":["id","imageUrl","altText","caption","authorDisplayName","createdAt"],"additionalProperties":false},"Sighting":{"$id":"#/components/schemas/Sighting","type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["found","rehidden"]},"note":{"anyOf":[{"type":"string"},{"type":"null"}]},"approxLat":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Approximate latitude (rounded for privacy), or null"},"approxLng":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Approximate longitude (rounded for privacy), or null"},"sighterDisplayName":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string","description":"ISO 8601 timestamp"}},"required":["id","type","note","approxLat","approxLng","sighterDisplayName","createdAt"],"additionalProperties":false},"Rock":{"$id":"#/components/schemas/Rock","type":"object","properties":{"code":{"type":"string"},"title":{"type":"string"},"note":{"anyOf":[{"type":"string"},{"type":"null"}]},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"imageAlt":{"anyOf":[{"type":"string"},{"type":"null"}]},"chapterSlug":{"anyOf":[{"type":"string"},{"type":"null"}]},"chapterName":{"anyOf":[{"type":"string"},{"type":"null"}]},"creatorDisplayName":{"type":"string"},"approxLat":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Approximate latitude (rounded for privacy), or null"},"approxLng":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Approximate longitude (rounded for privacy), or null"},"sightingCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"string","description":"ISO 8601 timestamp"}},"required":["code","title","note","imageUrl","imageAlt","chapterSlug","chapterName","creatorDisplayName","approxLat","approxLng","sightingCount","createdAt"],"additionalProperties":false},"RockDetail":{"$id":"#/components/schemas/RockDetail","type":"object","properties":{"code":{"type":"string"},"title":{"type":"string"},"note":{"anyOf":[{"type":"string"},{"type":"null"}]},"imageUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"imageAlt":{"anyOf":[{"type":"string"},{"type":"null"}]},"chapterSlug":{"anyOf":[{"type":"string"},{"type":"null"}]},"chapterName":{"anyOf":[{"type":"string"},{"type":"null"}]},"creatorDisplayName":{"type":"string"},"approxLat":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Approximate latitude (rounded for privacy), or null"},"approxLng":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Approximate longitude (rounded for privacy), or null"},"sightingCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"string","description":"ISO 8601 timestamp"},"journey":{"type":"array","items":{"$ref":"#/components/schemas/Sighting"},"description":"The rock's sightings, oldest first."},"stories":{"type":"array","items":{"$ref":"#/components/schemas/Story"},"description":"Published stories linked to this rock."}},"required":["code","title","note","imageUrl","imageAlt","chapterSlug","chapterName","creatorDisplayName","approxLat","approxLng","sightingCount","createdAt","journey","stories"],"additionalProperties":false},"Error":{"$id":"#/components/schemas/Error","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false},"ChapterList":{"$id":"#/components/schemas/ChapterList","type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Chapter"}}},"required":["data"],"additionalProperties":false},"StoryList":{"$id":"#/components/schemas/StoryList","type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Story"}}},"required":["data"],"additionalProperties":false},"GalleryList":{"$id":"#/components/schemas/GalleryList","type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/GalleryItem"}}},"required":["data"],"additionalProperties":false},"RockList":{"$id":"#/components/schemas/RockList","type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Rock"}}},"required":["data"],"additionalProperties":false}}}}