Backend developer documentation
Last Updated:
Introduction
VA.gov’s frontend repository (vets-website) uses vets-api as a service layer for all features. To expose new data or systems to vets-website, engineers should create an integration in vets-api. If you would like to expose an existing service's API, without an associated vets-website form, save in progress functionality, or prefill, please reach out to the Platform on slack for additional options.
The vets-api Platform is a wrapper around VA data services with utilities and tools that support interaction with those services on behalf of a Veteran. It exposes tools to retrieve information and submit data to VA systems, and does so with a unified sign-in mechanism. When services are down or are experiencing problems, vets-api integrations are designed to gracefully handle failures and provide useful notifications to consumers. vets-api is built on top of Ruby on Rails, providing a unified JSON-based REST interface and additional resilience for VA data services that may not be designed to operate directly with users 24x7.
Platform features
Authentication and authorization
PDF generation
Monitoring
Exception tracking
Downtime Notifications/Maintenance Windows
Development
See the vets-api Development documentation to get started with a local instance of vets-api and for guidance on how to submit changes and new features.
Integration overview
A vets-api integration must handle user requests, validate inputs, make one or multiple requests to another (external) service, and then render a response based on the results of those external service responses. To expose a service integration, a developer must:
Provide routing for a new endpoint on api.va.gov
Authorize requests to this endpoint appropriately through a policy
Validate user input or form submissions
Instantiate an External Service client connection and interact with an External Service
Serialize and render response data
vets-api provides utilities and patterns for appropriate instrumentation, error handling, and documentation for defining this integration consistently and resiliently. Refer to the guides in the sidebar for more information on how to utilize each of these features and develop an integration.
Help and feedback
Get help from the Platform Support Team in Slack.
Submit a feature idea to the Platform.