# Generic HTTP Adapter This is a generic HTTP adapter that can connect with a variety of different systems using the Python requests library. ## Adapter Config | Field | Description | Example | | | --------------------- | ---------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------ | | `Host` |

REQUIRED | Host of web server (note: web server is expected to use “https”).

The adapter assumes HTTPS is to be used. Unsecure HTTP is not supported.

Do not include any path components besides the domain name of the host (use [www.example.com](http://www.example.com) not )

| `www.example.com` | | `Basic Auth Username` |

OPTIONAL | Username for authenticating with remote host.

Mozilla docs: HTTP authentication - Basic authentication scheme

| `test-user` | | `Basic Auth Password` | OPTIONAL \| Password for authenticating with remote host. | `*********` | | | `Server Auth Cert` |

OPTIONAL | Certificate used to verify the identity of the remote server.

Certificates can come in many filetypes: .der, .cer, .crt, .cert, .pem, .p12, .pfx

Password protected .pfx / .p12 certificates are not currently supported.

| `server_certificate.cer` | | `Client Auth Cert` | OPTIONAL \| Certificate used to verify the identity of the requestor (Integration Gateway) to the remote server. | `client_certificate.pem` | | | `Timeout Seconds` | REQUIRED \| The number of seconds before the connection should time out. Min 1, max 120, default 60. | 60 | | ## Field Mappings
FieldDescriptionExample
url_pathREQUIRED | str | URL path to use with host.'/test/example'
methodREQUIRED | str | HTTP method to use in request.'POST'
body

OPTIONAL | multiple types | Payload in the request.

Setting a dict as the value will make the adapter set the Content-Type header to application/x-www-form-urlencoded.

To send JSON data, import the json module and use json.dumps(value).

JSON: json.dumps({'key': "value"})

Form data: {'key': "value"}

paramsOPTIONAL | dict | Key-value pairs to send as query parameters.

{'search': "foo", 'page': "3"}

params.search : "foo"

params.page : "3"

Resulting URL: https://www.example.com/url/path?search=foo,page=3

headers

OPTIONAL | dict | Key-value pairs representing headers for the request.

Consider using the Content-Type header to tell the remote host the type of content you are sending and/or the Accept header to tell the remote server what type of content you are willing/able to receive.

Hyphens do not work with dot.notation so please use ['bracket-notation'] in this case.

References

{
  'Content-Type': "application/xml",
  'Accept': "application/xml",
  'Some-Custom-Header': "Some custom value"
}

headers['Content-Type'] : "application/json"

headers.Accept : "application/octet-stream"

auth

OPTIONAL | tuple | Username and password used for basic authentication.

This overrides the Adapter Config Basic Auth Username and Password and should only be used in special circumstances.

For more info, please see the documentation on requests Basic Authentication features.

('username', 'p@$$w0rd')
force_response_content_type

OPTIONAL | str | Force the adapter to parse the response content in a certain way.

If not specified, the adapter dynamically parses the response according to its Content-Type header.
This optional field is likely unnecessary, but is nonetheless available for unique circumstances that may arise.

  • "json" | Adapter will parse the response as JSON, regardless of the response Content-Type header.

    • Returns JSON-like Python object, usually dict, list, but possibly str, int or float.

  • "xml" | Adapter will parse the response as XML, regardless of the response Content-Type header.

    • Returns a dict representing the XML data structure, following the same standard as most (if not all) Integration Gateway XML adapters.

  • "text" | Adapter will parse the response as plaintext, regardless of the response Content-Type header.

    • Returns a str.

  • "bytes" | Adapter will parse the response as binary data, regardless of the response Content-Type header.

    • Returns bytes

Using "json" will call the requests Response.json() method when parsing the response, and will raise an exception if the response is not valid JSON, causing the Service Request to fail.

Using "xml" will call the django_glyue_app.utils.xml_to_adapter_payload() method when parsing the response, and will raise an exception if the response is not valid XML, causing the Service Request to fail.

Using "text" or "bytes" should never raise an exception, and generally safe to use in all circumstances.

"json"

"xml"

"text"

"bytes"

#### Additional Information: the adapter attempts to parse the relevant content for the user based on the ‘content-type’ response header. These align with the `force_response_content_type` on the field mappings.