{"id":49488322,"url":"https://github.com/openapi/get-started-with-oauth-v2","last_synced_at":"2026-05-01T03:03:01.194Z","repository":{"id":354451742,"uuid":"1223688366","full_name":"openapi/get-started-with-oauth-v2","owner":"openapi","description":"📣 ANNOUNCEMENT: The Openapi® OAuth system just got a major upgrade V2.","archived":false,"fork":false,"pushed_at":"2026-04-28T17:00:32.000Z","size":221,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-28T17:24:15.211Z","etag":null,"topics":["certified-api","http-client","mcp-server","oauth","oauth2","oauth2-client","openapi","restapi"],"latest_commit_sha":null,"homepage":"https://console.openapi.com/apis/oauthv2/info","language":"Makefile","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/openapi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/contributing.md","funding":null,"license":"LICENSE","code_of_conduct":"docs/code-of-conduct.md","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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-28T15:00:04.000Z","updated_at":"2026-04-28T17:00:36.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/openapi/get-started-with-oauth-v2","commit_stats":null,"previous_names":["openapi/get-started-with-oauth-v2"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/openapi/get-started-with-oauth-v2","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openapi%2Fget-started-with-oauth-v2","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openapi%2Fget-started-with-oauth-v2/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openapi%2Fget-started-with-oauth-v2/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openapi%2Fget-started-with-oauth-v2/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/openapi","download_url":"https://codeload.github.com/openapi/get-started-with-oauth-v2/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openapi%2Fget-started-with-oauth-v2/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32483406,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-30T13:12:12.517Z","status":"online","status_checked_at":"2026-05-01T02:00:05.856Z","response_time":64,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["certified-api","http-client","mcp-server","oauth","oauth2","oauth2-client","openapi","restapi"],"created_at":"2026-05-01T03:02:59.600Z","updated_at":"2026-05-01T03:03:01.187Z","avatar_url":"https://github.com/openapi.png","language":"Makefile","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://openapi.com/\"\u003e\n    \u003cimg alt=\"Openapi OAuth V2\" src=\".github/assets/images/repo-header-a4.png\"\u003e\n  \u003c/a\u003e\n\n  \u003ch1\u003e🚀 OAuth V2 is now live\u003c/h1\u003e\n  \u003cp\u003eGranular token limits · Refresh-token rotation · Wallet transactions · Advanced stats · Full monitoring\u003c/p\u003e\n\n[![API Version](https://img.shields.io/badge/OAuth-v2.1.0-4f46e5)](https://console.openapi.com/apis/oauthv2/info)\n[![License](https://img.shields.io/github/license/openapi/get-started-with-oauth-v2)](LICENSE)\n[![Sandbox](https://img.shields.io/badge/sandbox-free-22c55e)](https://console.openapi.com/support#heading_3779)\n\u003cbr\u003e\n[![Linux Foundation Member](https://img.shields.io/badge/Linux%20Foundation-Silver%20Member-003778?logo=linux-foundation\u0026logoColor=white)](https://www.linuxfoundation.org/about/members)\n\u003cbr\u003e\n\n**[Read the docs →](https://console.openapi.com/apis/oauthv2/info)**\n\n\u003c/div\u003e\n\n---\n\n# 🔐 OAuth V2 — Get Started\n\nA curated collection of ready-to-run examples for the **[Openapi OAuth V2 API](https://console.openapi.com/apis/oauthv2/info)** — pick your language, set your credentials, and go.\n\n## What's new in V2?\n\n- **Granular token limits** — cap total requests, paid requests, wallet spend and allowed IPs per token\n- **Refresh-token rotation** — extend a token's TTL securely via `PATCH` without losing accumulated stats\n- **Wallet transactions** — paginated history of every credit and expense on your account\n- **Advanced stats** — aggregate metrics, unique IP lists, and per-domain / per-scope breakdowns\n- **Full monitoring** — inspect callback deliveries, active subscriptions and integration error logs\n\n## Documentation\n\n| Resource | Link |\n|---|---|\n| Getting started guide | [console.openapi.com/apis/oauthv2](https://console.openapi.com/apis/oauthv2/info) |\n| API Reference (Swagger UI) | [console.openapi.com/apis/oauthv2/documentation](https://console.openapi.com/apis/oauthv2/documentation#docs-swaggerui) |\n| Postman collection | [openapi.com/en/docs/oauth#postman](https://console.openapi.com/apis/oauthv2/documentation) |\n| OAS3 specification | [openapi.com/en/docs/oauth#oas3](https://console.openapi.com/apis/oauthv2/documentation) |\n\n## Examples\n\nEach subfolder contains self-contained, runnable examples for a specific language or tool.\n\n| Language / Tool | Folder |\n|---|---|\n| cURL | [`examples/curl`](examples/curl) |\n\n## Authentication\n\nAll endpoints use **HTTP Basic Auth** — your account email as username and your API key as password.\n\n```\nAuthorization: Basic base64(EMAIL:APIKEY)\n```\n\nThe only exception is token refresh: pass the refresh token as a **Bearer** token when calling `PATCH /tokens/{token}`.\n\n## Quick start\n\n1. Generate a token from the [Openapi console](https://console.openapi.com/oauth) or via API.\n2. Pick the examples folder for your language.\n3. Copy the snippet, set your credentials, run it.\n\n## Contributing\n\nContributions are always welcome! Whether you want to report bugs, suggest new features, improve documentation, or contribute code, your help is appreciated.\n\nSee [docs/contributing.md](docs/contributing.md) for detailed instructions on how to get started. Please make sure to follow this project's [docs/code-of-conduct.md](docs/code-of-conduct.md) to help maintain a welcoming and collaborative environment.\n\n## Authors\n\nMeet the project authors:\n\n- Openapi Team ([@openapi-it](https://github.com/openapi-it))\n\n## Partners\n\nMeet our partners using Openapi or contributing to this SDK:\n\n- [Blank](https://www.blank.app/)\n- [Credit Safe](https://www.creditsafe.com/)\n- [Deliveroo](https://deliveroo.it/)\n- [Gruppo MOL](https://molgroupitaly.it/it/)\n- [Jakala](https://www.jakala.com/)\n- [Octotelematics](https://www.octotelematics.com/)\n- [OTOQI](https://otoqi.com/)\n- [PWC](https://www.pwc.com/)\n- [QOMODO S.R.L.](https://www.qomodo.me/)\n- [SOUNDREEF S.P.A.](https://www.soundreef.com/)\n\n## Our Commitments\n\nWe believe in open source and we act on that belief. We became Silver Members\nof the Linux Foundation because we wanted to formally support the ecosystem\nwe build on every day. Open standards, open collaboration, and open governance\nare part of how we work and how we think about software.\n\n## License\n\nThis project is licensed under the [MIT License](LICENSE).\n\nThe MIT License is a permissive open-source license that allows you to freely use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the software, provided that the original copyright notice and this permission notice are included in all copies or substantial portions of the software.\n\nIn short, you are free to use this SDK in your personal, academic, or commercial projects, with minimal restrictions. The project is provided \"as-is\", without any warranty of any kind, either expressed or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose, and non-infringement.\n\nFor more details, see the full license text at the [MIT License page](https://choosealicense.com/licenses/mit/).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenapi%2Fget-started-with-oauth-v2","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopenapi%2Fget-started-with-oauth-v2","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenapi%2Fget-started-with-oauth-v2/lists"}