{"id":24019717,"url":"https://github.com/bpedro/postman-openapi-sync","last_synced_at":"2025-04-15T19:32:40.284Z","repository":{"id":66692900,"uuid":"340194827","full_name":"bpedro/postman-openapi-sync","owner":"bpedro","description":"Postman OpenAPI sync makes sure that your local OpenAPI spec is in sync with Postman.","archived":false,"fork":false,"pushed_at":"2021-02-19T14:33:48.000Z","size":10,"stargazers_count":10,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-29T00:11:16.762Z","etag":null,"topics":["api","openapi","postman","sync"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/bpedro.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":"2021-02-18T22:32:25.000Z","updated_at":"2024-08-11T04:44:32.000Z","dependencies_parsed_at":"2023-07-06T08:19:28.549Z","dependency_job_id":null,"html_url":"https://github.com/bpedro/postman-openapi-sync","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bpedro%2Fpostman-openapi-sync","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bpedro%2Fpostman-openapi-sync/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bpedro%2Fpostman-openapi-sync/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bpedro%2Fpostman-openapi-sync/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bpedro","download_url":"https://codeload.github.com/bpedro/postman-openapi-sync/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249138863,"owners_count":21218962,"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":["api","openapi","postman","sync"],"created_at":"2025-01-08T11:37:56.967Z","updated_at":"2025-04-15T19:32:40.280Z","avatar_url":"https://github.com/bpedro.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Postman OpenAPI sync\n\nPostman OpenAPI sync makes sure that your local OpenAPI spec is in sync with Postman. It does that by using your local OpenAPI spec as the source of truth and synchronizing its contents with Postman.\n\n## Installing\n\nTo install `postman-openapi-sync` simply clone this repository and then run:\n\n```\nnpm install -g\n```\n\n`postman-openapi-sync` will be installed globally on your system.\n\n## Running\n\nTo run `postman-api-sync` you must first create two environment variables:\n\n- `POSTMAN_API_KEY`: your Postman API key.\n- `POSTMAN_WORKSPACE_ID`: the ID of the workspace where you want to synchronize your API.\n\nThen, you can simply run:\n\n```\npostman-openapi-sync \u003copenapi_file\u003e\n```\n\nWhere `openapi_file` is your local OpenAPI specification file.\n\n## Flow\n\n1. Read a local OpenAPI specification file.\n2. Obtain the local API name and version from the specification file.\n3. Check if there is an API with the same name on Postman.\n4. If not, create an API with the same name and description as the local OpenAPI specification.\n5. Create an API version with the same value as the local OpenAPI specification, if one doesn't already exist.\n6. Update the API schema with the value from the local OpenAPI specification.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbpedro%2Fpostman-openapi-sync","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbpedro%2Fpostman-openapi-sync","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbpedro%2Fpostman-openapi-sync/lists"}