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

• Current:
• Proposed:

Set headers

• Current:
• Proposed:

HTTP basic authentication

• 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: *

Apinf

• Current:
• Proposed:

API Key Checks

• Current:
• Proposed:

Required roles

• Current:
• Proposed:

Via HTTP header

• Current:
• Proposed:

Via GET query parameter

• Current:
• Proposed:

Rate limit mode

• 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: