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

Rest api design #601

Merged
merged 11 commits into from
Oct 10, 2023
Merged

Rest api design #601

merged 11 commits into from
Oct 10, 2023

Conversation

dpgraham4401
Copy link
Member

Description

Removes a (surprising amount) of unused handler functions (django calls them views) from our rest API design. we also add the 'rcra' accronym (for Resource Conservation and Recovery) into our RESTful API url pattern to roughly signify that a resource is

  1. related to RCRA and not another EPA AA-ship like the clean water or clean air acts (there could be a site or epaId resource in those acts, although I'm not sure). This clarifies and makes the app a little more extensible if that information was added at a later date.
  2. the resource (again roughly) should follow the schemas described in the USEAP/e-manifest documentation.

We also update the auto generated OpenAPI page to better reflect the organization of resources, and add useful details about the requests/responses of our API endpoints.

Issue ticket number and link

Checklist

  • I have added tests that prove my fix is effective or that my feature works
  • I have commented my code, particularly in hard-to-understand areas
  • I have made corresponding changes to the documentation
  • My changes generate no new warnings

dependabot bot and others added 11 commits October 10, 2023 11:15
Bumps [zod](https://github.com/colinhacks/zod) from 3.22.2 to 3.22.3.
- [Release notes](https://github.com/colinhacks/zod/releases)
- [Changelog](https://github.com/colinhacks/zod/blob/master/CHANGELOG.md)
- [Commits](colinhacks/zod@v3.22.2...v3.22.3)

---
updated-dependencies:
- dependency-name: zod
  dependency-type: direct:production
...

Signed-off-by: dependabot[bot] <[email protected]>
our logic for how we interact with the manifest not really appropriate for a DRF model ViewSet. so we had a bunch of unused endpoints that was autoamtically created by DRF when we really just needed to RetreiveAPIView
…tablish the resource hierarchy in the RESTful api design

we want to establish that these are RCRA related resources that are not central to the haztrak application itself or another environmental act like the clean water act (CWA) which may have their own 'manifest' or definition of an 'EPA site'
@github-actions github-actions bot added client Related to front end workings (React/Redux) dependencies project dependency problems or modifications server Related to backend workings (Django/Rest API) test Unit tests are, or need to be, included labels Oct 10, 2023
@dpgraham4401 dpgraham4401 merged commit e41fe1e into USEPA:main Oct 10, 2023
9 checks passed
@dpgraham4401 dpgraham4401 deleted the rest_api_design branch October 10, 2023 19:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
client Related to front end workings (React/Redux) dependencies project dependency problems or modifications server Related to backend workings (Django/Rest API) test Unit tests are, or need to be, included
Projects
No open projects
Status: Done
Development

Successfully merging this pull request may close these issues.

1 participant