{"id":15091270,"url":"https://github.com/rhcarvalho/buffer-openapi-spec","last_synced_at":"2026-01-04T08:31:12.340Z","repository":{"id":66869415,"uuid":"134355205","full_name":"rhcarvalho/buffer-openapi-spec","owner":"rhcarvalho","description":"OpenAPI spec for the Buffer API","archived":false,"fork":false,"pushed_at":"2018-05-23T07:58:54.000Z","size":5,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-27T10:29:43.186Z","etag":null,"topics":["buffer","bufferapp","openapi","openapi-spec","openapi-specification","swagger","swagger-spec","swagger-specification"],"latest_commit_sha":null,"homepage":"https://buffer.com/developers/api","language":null,"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/rhcarvalho.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}},"created_at":"2018-05-22T03:24:20.000Z","updated_at":"2018-05-23T07:58:55.000Z","dependencies_parsed_at":"2023-05-31T16:00:38.935Z","dependency_job_id":null,"html_url":"https://github.com/rhcarvalho/buffer-openapi-spec","commit_stats":{"total_commits":6,"total_committers":1,"mean_commits":6.0,"dds":0.0,"last_synced_commit":"7e7e2f5ef182616752da4f2c2c3a6d109e40e0f3"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rhcarvalho%2Fbuffer-openapi-spec","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rhcarvalho%2Fbuffer-openapi-spec/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rhcarvalho%2Fbuffer-openapi-spec/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rhcarvalho%2Fbuffer-openapi-spec/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rhcarvalho","download_url":"https://codeload.github.com/rhcarvalho/buffer-openapi-spec/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244945596,"owners_count":20536295,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["buffer","bufferapp","openapi","openapi-spec","openapi-specification","swagger","swagger-spec","swagger-specification"],"created_at":"2024-09-25T10:36:47.869Z","updated_at":"2026-01-04T08:31:12.309Z","avatar_url":"https://github.com/rhcarvalho.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# buffer-openapi-spec\n\nThis is a community-driven OpenAPI spec for the [Buffer API](https://buffer.com/developers/api).\n\nIt is not an official specification.  \nIt is not endorsed by Buffer.\n\nAs the official API can change any time, there are no promises or guarantees.\nThis project intends to formally specify the API having in mind the benefits it\ncan bring, such as:\n\n- [Interactive documentation](https://petstore.swagger.io/)\n- [Autogenerated API clients](#generating-clients)\n- [API testing](https://inspector.swagger.io/)\n\n## OpenAPI 3.0 and OpenAPI 2.0 (Swagger)\n\n[OpenAPI 3.0](https://swagger.io/blog/announcing-openapi-3-0/) is the latest and\ngreatest revision of the OpenAPI Specification (OAS). However, the ecosystem of\ntools for the previous version, widely known as Swagger 2.0, is much more\nmature. In particular, there are more code generators built right into the\n[Swagger Editor](https://editor.swagger.io/).\n\nOnce the tools evolve to support the newer version better, it should be possible\nto [automatically migrate the\nspec](https://blog.runscope.com/posts/tutorial-upgrading-swagger-2-api-definition-to-openapi-3).\n\nSolely for that pragmatic reason, this spec currently uses the OAS2 / Swagger\n2.0 specification to describe Buffer's API.\n\n## Generating clients\n\nHaving a formal API specification opens up the possibility to autogenerate code\nfor API clients.\n\nThe OpenAPI / Swagger ecosystem provides tools to generate clients in many\ntarget programming languages.\n\nSee:\n\n- https://generator.swagger.io/\n- https://editor.swagger.io/\n\nPoint the tools to the URL below to generate clients using the latest version of the specification:\n\n    https://raw.githubusercontent.com/rhcarvalho/buffer-openapi-spec/master/buffer-openapi-spec.yaml\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frhcarvalho%2Fbuffer-openapi-spec","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frhcarvalho%2Fbuffer-openapi-spec","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frhcarvalho%2Fbuffer-openapi-spec/lists"}