Skip to content

README.md

Latest commit

 

History

History
43 lines (27 loc) · 2.34 KB

README.md

File metadata and controls

43 lines (27 loc) · 2.34 KB

Vaccination Eligibility Data Product - Specification

Overview

The eligibility-signposting-api is based on an OpenAPI specification maintained at /specification/eligibility-signposting-api.yaml. We use Redocly CLI to inject environment-specific elements into the base specification, allowing us to publish to different environments without manual editing or maintaining duplicate specifications.

Directory Structure

Each directory contains environment specific configuration for the specification. If the configuration doesn't exist for your chosen environment, then add it.

components/security/

Contains environment-specific security configurations for each endpoint.

x-nhsd-apim/

Contains APIM extensions to the OpenAPI specification with deployment requirements:

  • access: Environment-specific access patterns
  • rate-limit: API rate limiting configurations
  • target: API backend details for proxy configuration

Generating Environment-Specific Specifications

To build a specification for a specific environment:

  1. Set the target environment using the APIM_ENV parameter
  2. Run make construct-spec from the repository root, which:
    • Updates templates with environment-specific values
    • Uses Redocly to compile the complete specification to build/specification/
  3. For the sandbox environment, run make publish to convert the specification to JSON and save it to sandbox/specification/ for immediate use

Deploying Environment-Specific Specifications

See the Proxygen CLI user guide

We deploy our specifications using the Proxygen CLI. In order to do this, the following steps need to be performed:

  1. Construct the specification for the environment of your choice, following the instructions above.
  2. Run make retrieve-proxygen-key from the root directory to retrieve the private key needed to authenticate with Proxygen.
  3. Run make setup-proxygen-credentials from the root directory to set up credentials needed to interact with our API proxy.
  4. Run proxygen instance deploy <environment> eligibility-signposting-api ./build/specification/eligibility-signposting-api.yaml to deploy the specification to a chosen environment.