Fleet Rent Price Calculator
Service Description
Fleet Rent Price Calculator lets you know monthly rent of a vehicle based on given inputs. All you have to do is enter mileage, term and a car number. You can find out the car numbers from Fleet Cars For Rental API.
|
API Profile |
|
|---|---|
|
Attribute |
Value |
| Name | Fleet Rent Price Calculator |
| Version | V1 |
| Synopsis | Fleet Rent Price Calculator Service |
| Description | Returns monthly rent of rentable car |
| Pre-Conditions | HTTP POST method is allowed only in Fleet Rent Price Calculator Service |
| Authentication |
OAuth 2.0 with Client Credentials |
Before your application can access the API, it must obtain a new access token for each request. The access token can be used only one time.
Endpoint Definition
Routing information for Fleet Rent Price Calculator API live environment.
|
EndPoint / DEVELOPMENT SANDBOX SERVICE |
|
|---|---|
| URI | /gfy/rentcalculator/v1 |
| Base URL | https://apis.garantibbva.com.tr:443 |
Technology
|
Technology Stack / DESIGN TIME |
|
|---|---|
| Property | Value |
| HTTP Call Method | POST |
| Response Content Type | application/json |
Request
HTTP POST method is allowed only in Fleet Rent Price Calculator API.
Arguments
The list of arguments by the Fleet Rent Price Calculator API to be invoked
|
Request Fields |
Type |
Description |
Obligation |
|---|---|---|---|
| fleetCarId | Integer | Identity number of car | Mandatory |
| term | Integer | The information about how many months the car will be used | Mandatory |
| mileage | Integer | The information about how many kilometers the car will be used per year | Mandatory |
Sample Request
{
"fleetCarId": 429720,
"mileage": 10000,
"term": 12
}
Response
The Fleet Rent Price Calculator API returns the monthly rent of a car based on request parameters.
Arguments
|
Response Fields |
Type |
Description |
|---|---|---|
| monthlyRent | Decimal | The monthly rent amount of the given car |
Sample Response
{
"result": {
"returnCode": 200,
"reasonCode": "1",
"messageText": "Success"
},
"monthlyRent": 13700
}
Return Codes & Error Handling
Return codes from Fleet Rent Price Calculator service request
|
Code |
Description |
Type |
|---|---|---|
| 200 | OK | SUCCESS |
| 400 | Invalid Request | MISSING PARAMETERS |
| 401 | Invalid Credentials | UNAUTHORIZED |
| 405 | {http.method} Method Not Allowed | CALL METHOD ERROR |
| 429 | API plan limit exceeded | RATE LIMITING |
| 500 | Internal Server Error | SYSTEM ERROR |
Return Messages
|
CODE |
RETURN RESPONSE |
|---|---|
| 400 |
{
"result": {
"returnCode": 400,
"reasonCode": 0,
"messageText": "Invalid Request"
}
}
|
| 401 |
{
"result": {
"returnCode": 401,
"reasonCode": 0,
"messageText": "Invalid Credentials"
}
}
|
| 405 |
{
"result": {
"returnCode": 405,
"reasonCode": 0,
"messageText": "POST Method Not Allowed"
}
}
|
| 429 |
{
"result": {
"returnCode": 429,
"reasonCode": 0,
"messageText": "API plan limit exceeded"
}
}
|
| 500 |
{
"result": {
"returnCode": 500,
"reasonCode": 0,
"messageText": "Internal Server Error"
}
}
|
-
API URL : https://apis.garantibbva.com.tr:443
-
-
-