This article contains some common issues that users may experience when first trying to work with the Infoplus API.  If you are having trouble getting a new integration to work, please see if you're running into any of the issues listed here.  If you're still having issues, please get in touch with our Support Team for further assistance.


Content-Type: application/json

The Infoplus API uses only application/json as its Content-Type, for all types of requests (i.e., GET, POST, PUT).  


This means that any requests to the API which include a body (i.e., POST or PUT) MUST include an HTTP header of "Content-Type:application/json".  Furthermore, the body content of any POST or PUT's must be a well-formed JSON object (not an XML document, form-data, x-www-form-urlencoded, or anything else).  


Similarly, since all Infoplus API endpoints return Content-Type:application/json, your requests should include an HTTP header of "Accept:application/json" (or an equivalent, such as "Accept:*/json" or "Accept:*/*").  


If you violate any of these Content-Type requirements, you will most likely receive an invalid response, with an HTTP 503 response code.  


SSL Certificate Trust

The Infoplus API requires that all requests be issued over HTTPS, and the SSL certificate with which Infoplus signs all requests is one issued by AWS's Certificate Manager.  This can potentially cause an issue for API clients whose local security trust stores are not updated to be aware of the intermediate certificates in our trust chain, which were released in 2015.  


This error may present itself (for a client using a Java application) as javax.net.ssl.SSLHandshakeException: sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target.  Other client programming environments may offer similar error messaging.  


If you are running into this type of error, the way to solve it is to update your application/server to accept our SSL certificate (specifically, the intermediate certificates in our certificate's trust chain).  Oracle offers this path to update a java installation.  


Timezone Behavior

There is a bug in the implementation of timezones in versions 1, 2, and the current beta of the Infoplus API, where times are indicated as GMT/UTC, despite their values actually being shifted to be US Central time.  For example, a value returned by the Infoplus API of 2020-07-04T16:00:00.000Z should actually be: 2020-07-04T21:00:00.000Z (it is off by the US-Central timezone offset, which is 5 hours during daylight saving time, 6 hours during standard time).


To avoid this behavior, and get proper timezone behavior from the Infoplus API, you can include the HTTP header:  X-Infoplus-Proper-Timezone-Behavior with a value of 1 in your API requests.  


Non-ASCII Characters

If you are receiving a 400 error from the API, it may be because you are trying to submit a Non-ASCII character. The Infoplus API does not support Non-ASCII characters because the backend database will not accept them. One way that you can test your call is by using a ASCII checker like WISC ACSII Tester.


Example Error:

Response Code

400

Response Message

{errors=[An error has occurred saving this Item. Please try again or contact Support.]}


Example of Non-ASCII Characters

CharacterDescription
euro sign
single low-9 quotation mark
ƒlowercase letter f with hook
double low-9 quotation mark
horizontal ellipsis
dagger
double dagger
ˆmodifier letter circumflex accent
per mille sign
Šcapital letter S with caron
single left-pointing angle quotation
Œcapital ligature OE
Žcaptial letter Z with caron
left single quotation mark
right single quotation mark
left double quotation mark
right double quotation mark
bullet
en dash
em dash
˜tilde
TM trade mark sign
šlowercase letter S with caron
right-pointing angle quotation mark
œlowercase ligature oe
žlowercase letter z with caron
Ÿcapital letter Y with diaeresis
 non-breaking space
¡inverted exclamation mark
¢cent sign
£pound sign (currency)
¤currency sign
¥yen/yuan sign
¦broken vertical bar
§section sign
¨diaeresis
©copyright sign
ªfeminine ordinal indicator
«left double angle quotation mark (guillemet)
¬not sign (logic)
­soft/discretionary hyphen
®registered trade mark sign
¯spacing macron / overline
°degree sign
±plus/minus sign
²superscript two (squared)
³superscript three (cubed)
´acute accent
µmicro sign
paragraph sign (pilcrow)
·middle dot
¸cedilla
¹superscript one
ºmasculine ordinal indicator
»right double angle quotation mark (guillemet)
¼one quarter fraction (1 over 4)
½one half fraction (1 over 2)
¾three quarters fraction (3 over 4)
¿inverted question mark
Àcapital letter A with grave accent
Ácapital letter A with acute accent
Âcapital letter A with circumflex
Ãcapital letter A with tilde
Äcapital letter A with diaeresis
Åcapital letter A with ring above
Æcapital AE ligature
Çcapital letter C with cedilla
Ècapital letter E with grave accent
Écapital letter E with acute accent
Êcapital letter E with circumflex
Ëcapital letter E with diaeresis
Ìcapital letter I with grave accent
Ícapital letter I with acute accent
Îcapital letter I with circumflex
Ïcapital letter I with diaeresis
Ðcapital letter ETH(Dogecoin symbol)
Ñcapital letter N with tilde
Òcapital letter O with grave accent
Ócapital letter O with acute accent
Ôcapital letter O with circumflex
Õcapital letter O with tilde
Öcapital letter O with diaeresis
×multiplication sign
Øcapital letter O slash
Ùcapital letter U with grave accent
Úcapital letter U with acute accent
Ûcapital letter U with circumflex
Ücapital letter U with diaeresis
Ýcapital letter Y with acute accent
Þcapital letter THORN
ßlowercase letter sharp s (Eszett / scharfes S )
àsmall letter a with grave accent
álowercase letter a with acute accent
âlowercase letter a with circumflex
ãlowercase letter a with tilde
älowercase letter a with diaeresis
ålowercase letter a with ring above
ælowercase ae ligature
çlowercase letter c with cedilla (cé cédille)
èlowercase letter e with grave accent
élowercase letter e with acute accent
êlowercase letter e with circumflex
ëlowercase letter e with diaeresis
ìlowercase letter i with grave accent
ílowercase letter i with acute accent
îlowercase letter i with circumflex
ïlowercase letter i with diaeresis
ðlowercase letter eth
ñlowercase letter n with tilde
òlowercase letter o with grave accent
ólowercase letter o with acute accent
ôlowercase letter o with circumflex
õlowercase letter o with tilde
ölowercase letter o with diaeresis
÷division sign
ølowercase letter o with slash
ùlowercase letter u with grave accent
úlowercase letter u with acute accent
ûlowercase letter u with circumflex
ülowercase letter u with diaeresis
ýlowercase letter y with acute accent
þlowercase letter thorn
ÿlowercase letter y with diaeresis