Fleet Cars For Rental

Service Description

Fleet Cars For Rental API helps you getting information of cars that can be used in the rent service.

API Profile

Attribute

Value

Name Fleet Cars For Rental
Version V1
Synopsis Fleet Cars For Rental Service
Description Returns Car Information (Description and Identity Car Id) For Rentable Cars
Pre-Conditions HTTP GET method is allowed only in Fleet Cars For Rental 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 Cars For Rental API live environment.

EndPoint DEVELOPMENT SANDBOX SERVICE

URI /gfy/cars/v1
Base URL https://apis.garantibbva.com.tr:443


Technology

Technology Stack / DESIGN TIME

Property Value
HTTP Call Method GET
Response Content Type application/json

Request

HTTP GET method is allowed only in Fleet Cars For Rental API.

Arguments

No parameters are required to call Fleet Cars For Rental API.

 

Response

The Fleet Cars For Rental service returns the model descriptions and numbers of cars that can be also used in rent service.

 

Arguments
 

Response Fields

Type

Description

description String Model description of the car
fleetCarId Integer Identity number of the car

Sample Response

{
  "result": {
    "returnCode": 200,
    "reasonCode": "1",
    "messageText": "Success"
  },
  "fleetCarDescriptionDTOList": [
    {
      "fleetCarId": 1,
      "description": "Audi A3 CABRIO 35 TFSI 150HP DESIGN STR PI 2019"
    },
    {
      "fleetCarId": 2,
      "description": "Fiat 500L 1.3 MJ 95HP DUALOGIC CROSS 2018"
    }
  ]
}

 

Return Codes & Error Handling

Response codes used in Fleet Cars For Rental API

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