Getting Started with Yolcu360 Agency API

Copy

• Copy for LLM

  Copy page as Markdown for LLMs
• View as Markdown

  Open this page as Markdown
• Open in ChatGPT

  Get insights from ChatGPT
• Open in Claude

  Get insights from Claude
• Connect to Cursor

  Install MCP server on Cursor
• Connect to VS Code

  Install MCP server on VS Code

Overview

Yolcu360 Agency API is a RESTful API that allows our business partners to easily integrate with our car rental services. With this API, you can:

• Search for locations
• Query available vehicles
• Create reservations
• Process payments
• Manage orders

Quick Start

1. Obtaining an API Key

To use the API, you first need to obtain an API key and secret. To do this, log in to the agency portal at pro.yolcu360.com and create a new key from the API Keys section.

2. Authentication

You need to obtain a JWT token using your API key:

curl -X POST https://staging.api.pro.yolcu360.com/api/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "key": "YOUR_API_KEY",
    "secret": "YOUR_API_SECRET"
  }'

Successful response:

{
  "accessToken": "eyJhbGciOiJIUzI1NiIs...",
  "refreshToken": "dGhpc2lzYXJlZnJlc2h0b2tlbg...",
  "accessTokenExpireAt": "2024-12-26T10:30:00Z",
  "refreshTokenExpireAt": "2024-12-27T10:00:00Z"
}

3. API Calls

Use the accessToken you received in the Authorization header for all API calls:

curl -X GET https://staging.api.pro.yolcu360.com/api/v1/locations?query=istanbul \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Environments

Our API serves in two different environments:

⚠️ Important: Reservations made in the staging environment are not real and no payment is processed.

Error Handling

The API uses standard HTTP status codes:

• 200 OK - Request successful
• 201 Created - Resource created
• 400 Bad Request - Invalid request
• 401 Unauthorized - Authentication error
• 403 Forbidden - Authorization error
• 404 Not Found - Resource not found
• 429 Too Many Requests - Rate limit exceeded
• 500 Internal Server Error - Server error

Error responses are in the following format:

{
  "code": 1001,
  "description": "Invalid request parameters",
  "details": {
    "field": "checkInDateTime",
    "message": "Must be a future date"
  }
}

Flow Diagram

Support

For technical support:

• Email: api-support@yolcu360.com
• Documentation: api-docs.yolcu360.com