Helper Data Operations

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

GET /helper-data/car-classes

Authorization: Bearer YOUR_ACCESS_TOKEN

curl -X GET https://api.pro.yolcu360.com/api/v1/helper-data/car-classes \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

[
  {
    "id": 12,
    "name": "Lüks Elit"
  },
  {
    "id": 18,
    "name": "Moving van"
  },
  {
    "id": 19,
    "name": "15 passenger van"
  },
  {
    "id": 24,
    "name": "Small SUV"
  },
  {
    "id": 26,
    "name": "Large SUV"
  },
  {
    "id": 27,
    "name": "Exotic SUV"
  },
  {
    "id": 11,
    "name": "Büyük"
  },
  {
    "id": 2,
    "name": "Orta"
  },
  {
    "id": 17,
    "name": "12 passenger van"
  },
  {
    "id": 22,
    "name": "Small/medium truck"
  },
  {
    "id": 28,
    "name": "Four wheel drive"
  },
  {
    "id": 7,
    "name": "Kompakt"
  },
  {
    "id": 4,
    "name": "Prestij"
  },
  {
    "id": 1,
    "name": "Ekonomi"
  },
  {
    "id": 14,
    "name": "Mini"
  },
  {
    "id": 35,
    "name": "Fullsize elite"
  },
  {
    "id": 36,
    "name": "Premium elite"
  },
  {
    "id": 13,
    "name": "Mini Elit"
  },
  {
    "id": 3,
    "name": "Standart"
  },
  {
    "id": 23,
    "name": "Large truck"
  },
  {
    "id": 25,
    "name": "Medium SUV"
  },
  {
    "id": 5,
    "name": "Premium"
  },
  {
    "id": 9,
    "name": "Van"
  },
  {
    "id": 6,
    "name": "Konfor"
  },
  {
    "id": 20,
    "name": "Cargo van"
  },
  {
    "id": 31,
    "name": "Economy elite"
  },
  {
    "id": 10,
    "name": "SUV"
  },
  {
    "id": 15,
    "name": "Subcompact"
  },
  {
    "id": 16,
    "name": "Minivan"
  },
  {
    "id": 29,
    "name": "Special"
  },
  {
    "id": 34,
    "name": "Standard elite"
  },
  {
    "id": 38,
    "name": "Oversize"
  },
  {
    "id": 8,
    "name": "Lüks"
  },
  {
    "id": 21,
    "name": "Unique"
  },
  {
    "id": 32,
    "name": "Compact elite"
  },
  {
    "id": 33,
    "name": "Intermediate elite"
  },
  {
    "id": 37,
    "name": "Luxury elite"
  }
]

GET /helper-data/fuel-types

curl -X GET https://api.pro.yolcu360.com/api/v1/helper-data/fuel-types \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

[
  {
    "id": 2,
    "name": "Dizel"
  },
  {
    "id": 9,
    "name": "Unspecified"
  },
  {
    "id": 10,
    "name": "Multifuel"
  },
  {
    "id": 8,
    "name": "Benzin/Dizel"
  },
  {
    "id": 14,
    "name": "Dizel Elektrik"
  },
  {
    "id": 15,
    "name": "Benzin Elektrik"
  },
  {
    "id": 17,
    "name": "Dizel Hibrit"
  },
  {
    "id": 16,
    "name": "Hidrojen"
  },
  {
    "id": 5,
    "name": "LPG"
  },
  {
    "id": 1,
    "name": "Benzin"
  },
  {
    "id": 7,
    "name": "Hibrit"
  },
  {
    "id": 11,
    "name": "Elektrik"
  },
  {
    "id": 13,
    "name": "Benzin/Lpg"
  }
]

GET /helper-data/transmission-types

curl -X GET https://api.pro.yolcu360.com/api/v1/helper-data/transmission-types \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

[
  {
    "id": 1,
    "name": "Manuel"
  },
  {
    "id": 2,
    "name": "Otomatik"
  }
]
]

GET /helper-data/delivery-types

curl -X GET https://api.pro.yolcu360.com/api/v1/helper-data/delivery-types \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

[
  {
    "id": 7,
    "name": "Shuttle Bus"
  },
  {
    "id": 3,
    "name": "Ofis"
  },
  {
    "id": 1,
    "name": "Adrese Teslim"
  },
  {
    "id": 2,
    "name": "Vale Hizmeti"
  },
  {
    "id": 4,
    "name": "Terminal Dışı Buluşma Karşılama"
  },
  {
    "id": 5,
    "name": "Terminal İçi Ofis"
  },
  {
    "id": 6,
    "name": "Terminal Dışı Vale Hizmeti"
  }
]

GET /helper-data/suppliers

# Get all suppliers with pagination
curl -X GET "https://api.pro.yolcu360.com/api/v1/helper-data/suppliers?limit=10&offset=0" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

# Get only main suppliers
curl -X GET "https://api.pro.yolcu360.com/api/v1/helper-data/suppliers?hasParentID=false" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

# Get only subsuppliers
curl -X GET "https://api.pro.yolcu360.com/api/v1/helper-data/suppliers?hasParentID=true" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

{
  "limit": 10,
  "offset": 0,
  "total": 45,
  "results": [
    {
      "id": 123,
      "name": "Enterprise Rent-A-Car",
      "displayName": "Enterprise",
      "code": "ENTERPRISE",
      "parentID": null,
      "logo": "https://cdn.example.com/logos/enterprise.png"
    },
    {
      "id": 124,
      "name": "Enterprise Premium",
      "displayName": "Enterprise Premium",
      "code": "ENTERPRISE_PREMIUM",
      "parentID": 123,
      "logo": "https://cdn.example.com/logos/enterprise-premium.png"
    }
  ]
}

{
  "code": 2001,
  "description": "Unauthorized access. Valid JWT token required.",
  "details": {
    "message": "Authentication token is missing or invalid"
  }
}

{
  "code": 500,
  "description": "Internal server error occurred",
  "details": {
    "message": "Temporary service unavailability"
  }
}

class HelperDataService {
    constructor(apiClient) {
        this.apiClient = apiClient;
        this.cache = new Map();
    }

    async loadAllHelperData() {
        try {
            const [carClasses, fuelTypes, transmissionTypes, deliveryTypes] =
                await Promise.all([
                    this.getCarClasses(),
                    this.getFuelTypes(),
                    this.getTransmissionTypes(),
                    this.getDeliveryTypes()
                ]);

            return {
                carClasses,
                fuelTypes,
                transmissionTypes,
                deliveryTypes
            };
        } catch (error) {
            console.error('Failed to load helper data:', error);
            throw new Error('Unable to load reference data');
        }
    }

    async getCarClasses() {
        if (this.cache.has('carClasses')) {
            return this.cache.get('carClasses');
        }

        const response = await this.apiClient.get('/helper-data/car-classes');
        this.cache.set('carClasses', response.data);
        return response.data;
    }

    async getFuelTypes() {
        if (this.cache.has('fuelTypes')) {
            return this.cache.get('fuelTypes');
        }

        const response = await this.apiClient.get('/helper-data/fuel-types');
        this.cache.set('fuelTypes', response.data);
        return response.data;
    }

    async getTransmissionTypes() {
        if (this.cache.has('transmissionTypes')) {
            return this.cache.get('transmissionTypes');
        }

        const response = await this.apiClient.get('/helper-data/transmission-types');
        this.cache.set('transmissionTypes', response.data);
        return response.data;
    }

    async getDeliveryTypes() {
        if (this.cache.has('deliveryTypes')) {
            return this.cache.get('deliveryTypes');
        }

        const response = await this.apiClient.get('/helper-data/delivery-types');
        this.cache.set('deliveryTypes', response.data);
        return response.data;
    }

    clearCache() {
        this.cache.clear();
    }
}

// Usage example
const helperDataService = new HelperDataService(apiClient);

// Load all data at application startup
const helperData = await helperDataService.loadAllHelperData();

// Use in search filters
const searchFilters = {
    carClassIds: helperData.carClasses.map(c => c.id),
    fuelTypeIds: helperData.fuelTypes.map(f => f.id),
    transmissionTypeIds: helperData.transmissionTypes.map(t => t.id)
};