Skip to content
/ openapi Public

OpenAPI specification for Phrase Strings REST API

License

Notifications You must be signed in to change notification settings

phrase/openapi

Folders and files

NameName
Last commit message
Last commit date

Latest commit

b98419f · Dec 12, 2023
Oct 30, 2023
Dec 12, 2023
Nov 28, 2023
Jan 19, 2023
Dec 12, 2023
Sep 27, 2022
Nov 28, 2023
Dec 12, 2023
Nov 28, 2023
Apr 23, 2020
Oct 13, 2023
Jun 5, 2023
Sep 29, 2020
Oct 30, 2023
Jul 31, 2023
Jun 5, 2023
Apr 24, 2020
Nov 28, 2023
Feb 27, 2023
Nov 28, 2023
Jul 20, 2020
Oct 30, 2023
Jul 28, 2023
Jun 5, 2023
Nov 28, 2023
Nov 28, 2023
Feb 3, 2023
Nov 28, 2023

Repository files navigation

OpenAPI specification for Phrase

Commands

  • npm install installs the dependencies
  • npm start builds API clients
  • npm run docs generates API documentation in HTML
  • npm run watch starts a local server which you can reach at http://localhost:8080
  • npm run lint lints your changes

Contribution

This project relies on conventional commits used by release-please to generate proper changelogs and increment versions of the generated client libraries affected by the PR. Please use appropriate prefixes when giving titles to your PRs as they decide whether there will be a version bump and changelog entry.

These changelogs and version bumps are generated as a separate pull requests (one for each client library) and currently need to be merged manually.

Example

You added an endpoint in Phrase Strings. In this project you do the following:

  1. Add newly added schema (if any) to /schemas/ directory
  2. Add new endpoints to /paths/ directory and reference it in paths.yaml
  3. npm start to re-build the clients
  4. npm run docs to generate the documentation (and verify it in action using npm run watch)
  5. Open a PR with an informative title (e.g. feat(api): Add an API endpoint for cat pics)

Workflow

The following repositories are generated upon pushing to this one:

https://github.com/phrase/phrase-go

https://github.com/phrase/phrase-java

https://github.com/phrase/phrase-js

https://github.com/phrase/phrase-php

https://github.com/phrase/phrase-python

https://github.com/phrase/phrase-ruby

https://github.com/phrase/phrase-cli

Deployment diagram

Deployment diagram

Specification

http://spec.openapis.org/oas/v3.0.3

https://swagger.io/specification/#specification

https://swagger.io/docs/specification/about/

Get help / support

Please contact support@phrase.com and we can take more direct action toward finding a solution.