Errors uploading OpenAPI/Swagger JSON schema

Tim Askerov

I am working on an integration with FedEx API suite, specifically their rates & quotes endpoint.  I have already registered the API endpoint in the API Gateway, but in order to make API calls I need to load the metadata of the calls supported by that endpoint. I have downloaded the official OpenAPI/Swagger schema JSON file from the FedEx developer portal, and it contains the definitions of the API POST call and the various data structures included in API requests and responses:

When I try to load this file from the Documentation tab I get the following error:

Swagger document is invalid -

Data and type mismatch found. #/components/schemas/BaseProcessOutputVO/example/rateReplyDetails/0/ratedShipmentDetails/0/totalDiscounts

Data and type mismatch found. #/components/schemas/BaseProcessOutputVO/example/rateReplyDetails/0/ratedShipmentDetails/0/totalVatCharge

Data and type mismatch found. #/components/schemas/BaseProcessOutputVO/example/rateReplyDetails/0/ratedShipmentDetails/0/totalDutiesAndTaxes

...

Basically, every entity defined in the metadata file is getting rejected.

Has anyone ever worked with FedEx APIs in ION before?  Or perhaps has dealt with similar errors and knows how to fix them?

Thank you!

Tim Askerov

After a few hours of bashing my head against the desk I have finally fixed it thanks to this Stackoverflow post that pointed me in the right direction.

Infor must be using a very strict version of JSON schema validator that was getting tripped by trivial things, such as:

• Integer numbers in properties defined as type double.
• Numbers stored as-is in properties defined as arrays of integers (e.g. “123” instead of “[123]”)
• The null value in properties defined as type object (instead of just omitting those properties)
• Date and time-like strings in properties defined as type string (e.g. “2025-02-10” and “06:30:00”)
• etc.

It took many rounds of painstakingly editing the JSON schema file between retries before API Gateway finally accepted it.