Add API Backend form help text

This page contains a section for each field on the Add API Backend form. Within each section is existing or suggested help text.

Name

• Current: API's name
• Proposed: Name of API

Backend

API Umbrella

Define the server where the API is hosted. Multiple servers can be defined to perform load balancing.

Apinf

• Current:
• Proposed:

Backend protocol

• Current:
• Proposed:

Servers

• Current:
• Proposed:

Host

API Umbrella

Define the host that we will listen for, and then the host the API backend is listening for.

Apinf

• Current:
• Proposed:

Port

• Current:
• Proposed:

Host

• Current:
• Proposed:

Frontend host

• Current:
• Proposed:

Backend host

• Current:
• Proposed:

Matching URL Prefixes

API Umbrella

What URL prefixes should be routed to this backend?

Apinf

• Current:
• Proposed:

Url matches

Matching URL Prefixes in API Umbrella

API Umbrella

Tip: We recommend using trailing slashes when configuring these URL prefixes when possible (for example, using /wind/ instead of /wind). While not necessary, this helps prevent future overlapping conflicts (for example, if someone later wants to set up /windmill/).

Example: Incoming Frontend Request: http://api.data.govexample.json?param=value Outgoing Backend Request: http://api.data.govexample.json?param=value

Apinf

• Current:
• Proposed:

Frontend prefix

• Current:
• Proposed:

Backend prefix

• Current:
• Proposed:

Documentation

• Current:
• Proposed:

Documentation link

• Current:
• Proposed:

Upload documentation

• Current:
• Proposed:

Documentation Configuration File

• Current:
• Proposed:

Create new documentation

• Current:
• Proposed:

Global Request Settings

• Current:
• Proposed:

Append query string parameters

API Umbrella

Placeholder text:

param1=value&param2=value

Apinf

• Current:
• Proposed:

Set headers

API Umbrella

Field name: Set Request Headers

Placeholder text:

X-Example-Header: value

Apinf

• Current:
• Proposed:

HTTP basic authentication

API Umbrella

Placeholder text:

username:password

Apinf

• Current:
• Proposed:

HTTPS requirements

API Umbrella

Define header values that will be set in the response regardless of whether the header is already set in the response.

For example, to set default CORS headers on all responses that don"t explicitly set their own CORS headers:

Access-Control-Allow-Origin: *

Select input options

• Key: Inherit (default - required & return message)
  • Value: [default?]
• Key: Required & return message - HTTP requests will receive a message to use HTTPS
  • Value: required_return_error
• Key: Required & return redirects - HTTP requests will be redirected to HTTPS
  • Value: required_return_redirect
• Key: Transitionary & return message - Optional for existing API keys, required for new API keys
  • Value: transition_return_error
• Key: Transitionary & return redirects - Optional for existing API keys, required for new API keys
  • Value: transition_return_redirect
• Key: Optional - HTTPS is optional
  • Value: optional

Apinf

• Current:
• Proposed:

API Key Checks

API Umbrella

Selection options (key/value)

• key
  • value
• Inherit (default - required)
  • [default?]
• Required - API keys are mandatory
  • [required?]
• Disabled - API keys are optional
  • value

Apinf

• Current:
• Proposed:

Required roles

• Current:
• Proposed:

Via HTTP header

• Current:
• Proposed:

Via GET query parameter

• Current:
• Proposed:

Rate limit mode

API Umbrella

Select options

• key
  • value
• Default rate limits
  • [default?]
• Custom rate limits
  • custom
• Unlimited requests
  • unlimited

Apinf

• Current:
• Proposed:

Advanced Requests Rewriting

• Current:
• Proposed:

Rewrite

• Current:
• Proposed:

Matcher type

• Current:
• Proposed:

HTTP method

• Current:
• Proposed:

Frontend matcher

• Current:
• Proposed:

Backend replacement

• Current:
• Proposed:

Advanced Settings

• Current:
• Proposed:

Balance algorithm

• Current:
• Proposed:

Error templates

• Current:
• Proposed:

JSON

• Current:
• Proposed:

XML

• Current:
• Proposed:

CSV

• Current:
• Proposed: