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"
  }
}