Skip to content

DevOps Division Guidebook

Best practice for API design

Initializing search

Developer Hub Project

Home
Contact us
How-to
Tutorials
Explanations
Reference
Our Services

DevOps Division Guidebook

Developer Hub Project

Home
Contact us
Contact us
How-to
How-to
- Products
  Products
- Git/GitLab
  Git/GitLab
- Development
  Development
- Entra ID and Azure Apps
  Entra ID and Azure Apps
- GKE GitLab Runners
  GKE GitLab Runners
- Python
  Python
- Deployment
  Deployment
  - Synchronise 1password secrets to Google Cloud
  - Create GitLab deploy token for Ansible deployment
- Cloud Platform
  Cloud Platform
  - Responding to billing alerts
  - Create Google Cloud Admin accounts
- Renovatebot
  Renovatebot
- AWS
  AWS
Tutorials
Tutorials
Explanations
Explanations
- Google Cloud admin accounts
- Service infrastructure and product factories
- Identifiers
- Webapp developer environment
- The Tech Lead Forum
- Renovatebot
- Cloud Platform
  Cloud Platform
- Git/GitLab
  Git/GitLab
- GKE GitLab Runners
- Python
  Python
  - How we use PyPI
Reference
Reference
- Other sources of documentation
- Well-known Identifier Scopes
- Local app development
- The Tech Lead Forum
- Standards and Compliance
- Standard architecture diagrams
- Git/GitLab
  Git/GitLab
- Best Practice
  Best Practice
- Cloud Platform
  Cloud Platform
- App Deployment
  App Deployment
- Working Environment
  Working Environment
  - Culture and Values
  - Meeting room locations
- Glossary
- Workflow
  Workflow
- Notes
  Notes
Our Services
Our Services
- Education
  Education
  - Camdata
  - Gates trust selection module
  - Digital Admissions
    Digital Admissions
    
    Digital pooling
    
    My cambridge application
  - ESSM Sync
  - Events
  - Examoffice
  - Laboratory Allocation
    Laboratory Allocation
    
    Lab allocator
    
    Legacy nst ia labs
  - Lecture Capture
    Lecture Capture
    
    Panopto deployment
  - Panel
  - Streaming media
  - UTBS
  - Yuja Enterprise Video Platform
- HR Systems
  HR Systems
- Infrastructure and Generic Services
  Infrastructure and Generic Services
  - Api gateway
  - Design system
  - Data backup
  - Equipshare
  - GAOBase
  - GitLab
  - Governance
    Governance
    
    Governance
    
    Reporter
    
    Statutes and ordinances
  - Identity and Access Management
    Identity and Access Management
    
    Activate account
    
    Card Management
    Card Management
    
    Card management system
    
    Legacy card db
    
    Network Tokens
    
    Google Workspace
    
    Gsuite preferences
    
    Iam overview
    
    Jackdaw
    
    Lookup
    
    Raven
    Raven
    
    Passwords
    
    Metadata
    
    OAuth2
    
    Webauth to SAML2
    
    SAML2
    
    Statistics API
    
    UCamWebAuth
    
    University human resources api
    
    University student api
  - Information asset register
  - Lookup gitlab sync
  - Malware and virus scanner
  - Nursery waiting list
  - Regent house ballots
  - Scribe
  - Self service gateway
  - Symphony
  - Talks cam
  - Ups service definition
- Research
  Research
- Internal
  Internal
  - Renovatebot
- Retired Services
  Retired Services

Best practice for API design¶

This section needs fleshing out.

GDS has a nice overview document on API design.

Made with Material for MkDocs