Read Settings

Retrieves the details of a Settings object that has been previously created.

Parameters

Path Params

yourCompany:

string
The Company name need to passed in the base URL.For eg. if you enter xyzcompany name, the url https://{yourCompany}.agiliron.net/agiliron/api-40.php/Settings will change to https://xyzcompany.agiliron.net/agiliron/api-40.php/Settings

Query Params

settingName:

string
In this parameter settingname needs to be provided with module if needed to fetch related details.

  1. To fetch Settings related to Currency Configuration, the following url must be used

https://xyzcompany.agiliron.net/agiliron/api-40/Settings?settingName=currency-configuration-settings&key=xyzkey

module:

string
In this parameter module needs to be provided with settingName to fetch related details.

  1. To fetch Settings related to custom fields of Products module , the following url must be used

https://xyzcompany.agiliron.net/agiliron/api-40/Settings?settingName=custom-field-settings&module=Products&key=xyzkey

username:

string
In this parameter username needs to be provided whenever it is required with settingName and module to fetch related details.

  1. To fetch Settings related to fields accessiblity of Products module , the following url must be used

https://xyzcompany.agiliron.net/agiliron/api-40/Settings?settingName=field-accessibility&module=Products&username=xyz&key=xyzkey

Header Params

key:

string
API key needs to be passed in this variable.The option to enter API key will appear when you click on Try it button.

Query Auth

key:

string
API key needs to be passed in this variable.The option to enter API key will appear when you click on Try it button.This will be the first option in AUTHENTICATION block.Default is SET to 0.

Header Auth

apiKey:

string
Dedicated API key needs to be passed in this variable via header.The option to enter API key will appear when you click on Try it button.This will be the second option in AUTHENTICATION block.Default is SET to 0.

Sample Code

{
    "CurrencyConfiguration": {
        "Currency": [
            {
                "CurrencyName": "US Dollar",
                "CurrencyCode": "USD",
                "CurrencySymbol": "$",
                "ExchangeRate": "1.00000",
                "IsDefault": "true"
            },
            {
                "CurrencyName": "CAD",
                "CurrencyCode": "CAD",
                "CurrencySymbol": "C$",
                "ExchangeRate": "0.78000",
                "IsDefault": null
            },
            {
                "CurrencyName": "Pound Sterling",
                "CurrencyCode": "GBP",
                "CurrencySymbol": "u00a3",
                "ExchangeRate": "1.13000",
                "IsDefault": null
            },
            {
                "CurrencyName": "EUR",
                "CurrencyCode": "EUR",
                "CurrencySymbol": "$",
                "ExchangeRate": "1.55000",
                "IsDefault": null
            }
        ],
        "TotalRecords": "4",
        "CurrentPage": "1",
        "TotalPages": "1",
        "PageSize": "50"
    }
}
<CurrencyConfiguration>
    <Currency>
        <CurrencyName>US Dollar</CurrencyName>
        <CurrencyCode>USD</CurrencyCode>
        <CurrencySymbol>$</CurrencySymbol>
        <ExchangeRate>1.00000</ExchangeRate>
        <IsDefault>true</IsDefault>
    </Currency>
    <Currency>
        <CurrencyName>CAD</CurrencyName>
        <CurrencyCode>CAD</CurrencyCode>
        <CurrencySymbol>C$</CurrencySymbol>
        <ExchangeRate>0.78000</ExchangeRate>
        <IsDefault></IsDefault>
    </Currency>
    <Currency>
        <CurrencyName>Pound Sterling</CurrencyName>
        <CurrencyCode>GBP</CurrencyCode>
        <CurrencySymbol>£</CurrencySymbol>
        <ExchangeRate>1.13000</ExchangeRate>
        <IsDefault></IsDefault>
    </Currency>
    <Currency>
        <CurrencyName>EUR</CurrencyName>
        <CurrencyCode>EUR</CurrencyCode>
        <CurrencySymbol>$</CurrencySymbol>
        <ExchangeRate>1.55000</ExchangeRate>
        <IsDefault></IsDefault>
    </Currency>
    <TotalRecords>4</TotalRecords>
    <CurrentPage>1</CurrentPage>
    <TotalPages>1</TotalPages>
    <PageSize>50</PageSize>
</CurrencyConfiguration>

WADL

<?xml version="1.0" encoding="utf-8"?>
<application>
   <resources base="https://{yourCompany}.agiliron.net/agiliron/api-40/">
     <resource path="Settings"> 
       <method name="GET">
         <request>
           <param name="key" type="xsd:string" style="query" required="true"/>
           <param name="settingName" type="xsd:string" style="query"/>
           <param name="module" type="xsd:string" style="query"/>
         </request> 
         <response status="200"> 
            <representation mediaType="application/xml" element="yn:ResultSet"/> 
         </response> 
         <response status="400"> 
            <representation mediaType="application/xml" element="ya:Error"/> 
         </response> 
       </method> 
     </resource> 
   </resources>
 </application>

© Copyright 2022 Agiliron - All Rights Reserved.