developing the Custom API using IONAPI

Legacy Contributor

Hello Everyone

Greetings!. I am new to IONAPI and we have received requirement from one of our supplier to develop Rest-API and publish in our domain, so that they can connect to our domain and consume these API Endpoint to pull the data.

We need your valuable feedback on how to develop this API using IONAPI? Does anybody has document which has examples of API development?

I have done few basic workouts to reach the solution

1. Was trying to develop web service using MWS Designer that supports SOAP API, I came to know ION API does not supports SOAP API publish?

2. Working with MDBREADMI and found that API supports only one Database table.

3. Working with CMS010, CMS015 and found that it does not support complex requirements

{
  "items": [
    {
      "contractId": "B30101",
      "poNumber": "PO-10001",
      "paymentType": "Check",
      "pickupPerson": "Mike Portnoy",
      "pickupPhone": "614-555-1001",
      "salesRep": "Tony Royster Jr.",
      "properties": {
        "total": 2179,
        "signedBy": "Mike Mangini"
      },
      "jobsiteId": "20001",
      "locationId": "COLU",
      "customerId": "7771001",
      "contractType": "Rental",
      "contractStartDate": "2019-12-01T12:00:00Z",
      "contractEndDate": "2020-06-30T12:00:00Z",
      "assetDetails": [
        {
          "rentedAssetId": "100006",
          "status": "Active",
          "attachedTo": null,
          "itemType": "prime",
          "rentalTotal": 2179,
          "quantity": 1,
          "assetId": "B271001",
          "assetName": "BACKHOE LOADER, 416 4WD",
          "categoryId": "CatId-BACKHOES",
          "longDescription": "416 4WD BACKHOE LOADER",
          "shortDescription": "416",
          "rentalRate": {
            "rateType": "customer",
            "daily": {
              "amount": 399,
              "currency": "USD",
              "display": "399.00"
            },
            "monthly": {
              "amount": 2179,
              "currency": "USD",
              "display": "2179.00"
            },
            "weekly": {
              "amount": 899,
              "currency": "USD",
              "display": "899.00"
            },
            "rentalRateId": ""
          },
          "equipmentAssetId": "ead006",
          "manufacturer": "CATERPILLAR INC.",
          "serialNumber": "BC416101R"
        },
        {
          "rentedAssetId": "100049",
          "status": "Active",
          "attachedTo": null,
          "itemType": "attachment",
          "rentalTotal": 279,
          "quantity": 1,
          "assetId": "B278801",
          "assetName": "BACKHOE BUCKET, 16in",
          "categoryId": "CatId-BACKHOES",
          "longDescription": "16in BACKHOE BUCKET",
          "shortDescription": "BACKHOE BUCKET, 16in",
          "rentalRate": {
            "rateType": "customer",
            "daily": {
              "amount": 39,
              "currency": "USD",
              "display": "39.00"
            },
            "monthly": {
              "amount": 279,
              "currency": "USD",
              "display": "279.00"
            },
            "weekly": {
              "amount": 99,
              "currency": "USD",
              "display": "99.00"
            },
            "rentalRateId": ""
          },
          "equipmentAssetId": "ead049",
          "manufacturer": "CATERPILLAR INC.",
          "serialNumber": "BB16101R"
        },
        {
          "rentedAssetId": "100031",
          "status": "Active",
          "attachedTo": null,
          "itemType": "prime",
          "rentalTotal": 959,
          "quantity": 1,
          "assetId": "B751001",
          "assetName": "CONCRETE BUGGY, POWERED",
          "categoryId": "CatId-CONCRETE",
          "longDescription": "POWERED CONCRETE BUGGY",
          "shortDescription": "CONCRETE BUGGY",
          "rentalRate": {
            "rateType": "customer",
            "daily": {
              "amount": 149,
              "currency": "USD",
              "display": "149.00"
            },
            "monthly": {
              "amount": 959,
              "currency": "USD",
              "display": "959.00"
            },
            "weekly": {
              "amount": 359,
              "currency": "USD",
              "display": "359.00"
            },
            "rentalRateId": ""
          },
          "equipmentAssetId": "ead031",
          "manufacturer": "WHITEMAN",
          "serialNumber": "COBUG101R"
        },

Thanks

Mohamed Sithik

Legacy Contributor

ION API gateway is an API management layer that offers Industry standard inbound Security (OAuth 2.0) and various policies such as Security threat detection like preventing DDoS, code injection etc; Quota; Transformation; Caching and many more - that can enrich your API. Finally we have added API Orchestration this year which is our first step in the direction of letting users create brand new APIs. The API orchestration does this by letting you chain your EXISTING APIs, create a complex flow based on BPMN patterns and exposing this flow as a new API. There are still no options though (as we speak) in the gateway to create a net new Custom API. This is a large ongoing roadmap topic to allow modelling and hosting of new APIs via gateway with no projected ETA known at this time. 

So, I think you cannot achieve what you are looking for using ION API Gateway today. Having said that, you should be able to use the Tech platform of your underlying cloud suite (Is it M3 based, looking at your examples? In which case you can do this in IEC?) and use the extensibility options available there to create your API.

Another option for you is to use the Mongoose platform to develop brand new APIs, which can be exposed via ION API Gateway. 

And to your other point, ION API gateway does support proxying SOAP APIs. If you have a given client who can make SOAP calls, then you can call this proxy. However, some avenues of Infor OS such as - calling an ION API from an ION data flow/ workflow or from Coleman Digital Assistant or from App builder - supports only the modern standards and require that the API must be RESTful. 

Hope this helps.