Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[API] Endpoint: Snapshot [global] [GET - 200] #301

Open
5 tasks
JFQueralt opened this issue Feb 18, 2021 · 1 comment
Open
5 tasks

[API] Endpoint: Snapshot [global] [GET - 200] #301

JFQueralt opened this issue Feb 18, 2021 · 1 comment
Labels
Module: API Issues related to the API. ⌨ Need: Code This Issue involves some sort of coding. Project: PLD Issue related to Project Lockdown. ⌨ Team: Devs Task related to Team Developers. 📑 Team: Docs Task related to Team Documentation.

Comments

@JFQueralt
Copy link
Member

JFQueralt commented Feb 18, 2021

logo

The current v1.0 implementation does not allow to centrally manage the global and module-specific application variables.
It also doesn't allow to extract the necessary information to render different DSLs on demand.

For full context on this issue, check its related Epic #64

💡 Proposed solution

Implement an API that will provide with the following services as described below.

Endpoint documentation

Find all details on Usage, Parameters, Consumers and Responses here:
https://theiofoundation.stoplight.io/docs/projectlockdown/API/Reference/Project-Lockdown.v1.json/paths/~1Snapshots~1%7BSnapshotUID%7D~1%7BModule%7D~1%7BDateStart%7D~1%7BDateEnd%7D~1%7BDSLUID%7D/get

Definition of Done

  • Response Codes: 200
  • Deployed to production server (manually done until [CI] create deployment pipeline for API code #314)
  • Requests are cached to limit impact on servers/database
  • Response is provided in JSON format, but has option to add other formats in the future
  • Basic unit tests on the code

📚 Resources

Project documentation

API Technical documentation

  • API reference (includes mock server): Stoplight
  • JSON Models reference (schemas): Stoplight

Note: For full documentation reference and proposed tools please check the corresponding Epic.

@JFQueralt JFQueralt added Module: API Issues related to the API. Project: PLD Issue related to Project Lockdown. ⌨ Need: Code This Issue involves some sort of coding. ⌨ Team: Devs Task related to Team Developers. 💧 Priority: Medium This task has Medium priority. 📑 Team: Docs Task related to Team Documentation. 🚧 Stage: Not Ready This Task is not yet ready and its description needs to be finalized. labels Feb 18, 2021
@JFQueralt JFQueralt mentioned this issue Feb 18, 2021
24 tasks
@jeff-knurek jeff-knurek removed 💧 Priority: Medium This task has Medium priority. 🚧 Stage: Not Ready This Task is not yet ready and its description needs to be finalized. labels Jun 12, 2021
@jeff-knurek jeff-knurek changed the title [API] Endpoint: Snapshots [API] Endpoint: Snapshot [global] [GET - 200] Jun 12, 2021
@jeff-knurek
Copy link
Contributor

While the Documentation is being updated to be more streamline, and the frontend had already created a mock api response to use the data, here is the example of what the response content should look like:
https://github.com/TheIOFoundation/ProjectLockdown/blob/master/MAP/public/data/snapshot.json

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Module: API Issues related to the API. ⌨ Need: Code This Issue involves some sort of coding. Project: PLD Issue related to Project Lockdown. ⌨ Team: Devs Task related to Team Developers. 📑 Team: Docs Task related to Team Documentation.
Development

No branches or pull requests

2 participants