{"id":30108048,"url":"https://github.com/trivedi-khushi/openapi-sample-library","last_synced_at":"2026-03-10T14:05:53.885Z","repository":{"id":304648368,"uuid":"1019416177","full_name":"trivedi-khushi/openapi-sample-library","owner":"trivedi-khushi","description":"Curated library of 20+ real-world API examples with request/response schemas and CI automation for docs generation","archived":false,"fork":false,"pushed_at":"2025-08-11T09:16:39.000Z","size":146,"stargazers_count":8,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-20T05:39:37.175Z","etag":null,"topics":["apis","docker","documentation","good-first-issue","hacktoberfest","oas","openapi","openapispecification","redoc-cli","restapi","swagger-ui","webapi"],"latest_commit_sha":null,"homepage":"","language":"MDX","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/trivedi-khushi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-14T09:41:52.000Z","updated_at":"2025-09-25T11:19:13.000Z","dependencies_parsed_at":"2025-07-14T13:58:19.400Z","dependency_job_id":"12cc83a2-e39d-4cd8-82b1-761e16f2367c","html_url":"https://github.com/trivedi-khushi/openapi-sample-library","commit_stats":null,"previous_names":["trivedi-khushi/openapi-sample-library"],"tags_count":4,"template":true,"template_full_name":null,"purl":"pkg:github/trivedi-khushi/openapi-sample-library","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trivedi-khushi%2Fopenapi-sample-library","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trivedi-khushi%2Fopenapi-sample-library/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trivedi-khushi%2Fopenapi-sample-library/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trivedi-khushi%2Fopenapi-sample-library/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/trivedi-khushi","download_url":"https://codeload.github.com/trivedi-khushi/openapi-sample-library/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trivedi-khushi%2Fopenapi-sample-library/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30336122,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-10T12:41:07.687Z","status":"ssl_error","status_checked_at":"2026-03-10T12:41:06.728Z","response_time":106,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["apis","docker","documentation","good-first-issue","hacktoberfest","oas","openapi","openapispecification","redoc-cli","restapi","swagger-ui","webapi"],"created_at":"2025-08-10T02:02:41.744Z","updated_at":"2026-03-10T14:05:53.866Z","avatar_url":"https://github.com/trivedi-khushi.png","language":"MDX","funding_links":[],"categories":[],"sub_categories":[],"readme":"## ℹ️  About the Project - \nCurated library of 20+ real-world API examples with request/response schemas and CI automation for docs generation. [Read about the project workflow \u0026 design decisions!](https://khushitrivedi.hashnode.dev/openapi-sample-library-project)\n\n## 📎 How to Contribute?\nRead the Contribution Guide [here](https://khushitrivedi.hashnode.dev/openapi-sample-library-project#heading-contribution-guidelines)\n\n## 🪙 Key Project Insights (KPIs of this Project)\n1. Use of `$ref` to refere \u0026 split all the API spec instead of  listing them all in one .yaml file. Gives reusability, efficiant maintanace.\n\n2. Containerized environment using Docker to serve the API documentation locally via Redoc and Swagger UI.\n\n3. The project runs entirely in Docker without requiring to set-up any local dependencies like: Node.js, Python. simply install [Docker](https://www.docker.com/products/docker-desktop/)\n\n4. Anyyone can clone and preview the spec using a one-liner Docker command. (irrecspective of Operating system)\n\n5. Bundling Workflow- this project comes with built-in automcation to bundle all the OpenAPI specs into a single `bundled.yaml` file (for CI/CD or publishing).\n\n6. Contribute to this project without the tension of accidentally committing your local/generate files. This project file `.gitignore` automatically ignores committing such files.\n\n\n## 🧪 Selected APIs with their strengths:\n\n#### [GitHub API](https://docs.github.com/en/rest)\n\n- **Strengths:** Version control, Developer-centric, CRUD operations on repos/issues.\n\n- **Good Endpoints:** GET `/users/{username} (Retrieve user details)` POST `/repos/{owner}/{repo}/issues (Create issue)`\n\n#### [Stripe API](https://stripe.com/docs/api)\n\n- **Strengths:** Payment \u0026 Finance operations, Secure transaction examples.\n\n- **Good Endpoints:** POST `/customers (Create new customer)` GET `/charges/{id} (Retrieve payment details)`\n\n#### [Jira API](https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/)\n\n- **Strengths:** Project management, agile methodology, issues, tickets.\n\n- **Good Endpoints:** GET `/issue/{issueIdOrKey} (Retrieve issue details)` POST `/issue (Create new issue)`\n\n#### [Notion API](https://developers.notion.com/reference)\n\n- **Strengths:** Documentation management, productivity, content structures.\n\n- **Good Endpoints:** POST `/pages (Create new page)` GET `/databases/{database_id}/query (Retrieve database content)`\n\n#### [Slack API](https://api.slack.com/methods)\n- **Strengths:** Communication, messaging, webhooks.\n\n- **Good Endpoints:** POST `/chat.postMessage (Send a message)`GET `/conversations.history (Retrieve message history)`\n\n## 🛠️ Troubleshooting\n\n- Ensure file paths in `$ref` are correct and relative.\n\n- Docker port `8080` must not be in use by another application.\n\n- Validate the spec using Swagger Editor or redocly lint.\n\n- Avoid using backslashes (`\\`) on Windows in your YAML. Always use forward slashes (`/`), even on Windows.\n\n- Check carefully for formatting while working with YAML files.\n\n- Try using `docker pull redocly/redoc` incase of an error like \"Docker Image Not Found\"\n\n- **Reach out to https://www.github.com/trivedi-khushi for any queries/concerns.** 🙋‍♀️\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftrivedi-khushi%2Fopenapi-sample-library","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftrivedi-khushi%2Fopenapi-sample-library","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftrivedi-khushi%2Fopenapi-sample-library/lists"}