GikMobil API Documentation

Integrate predictive vehicle diagnostics into your application

Quick Start

📝

1. Register

Create a developer account and request API access

🔑

2. Get API Key

Receive your API key and authentication credentials

🔨

3. Integrate

Use our REST API to integrate with your platform

🚀

4. Deploy

Go live and start monitoring vehicle health

Base URL

https://api.gikmobil.com/v1

Authentication

API Key Authentication

Include your API key in the Authorization header of every request:

curl -H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
https://api.gikmobil.com/v1/vehicles

API Rate Limits

  • • 1000 requests per hour
  • • 10000 requests per day
  • • Webhook events included
  • • Higher limits on enterprise plans

Security

  • • TLS 1.2+ encryption
  • • IP whitelisting available
  • • Webhook signature verification
  • • OAuth 2.0 support

Core Endpoints

GET /vehicles

Get list of vehicles associated with user account

{ "vehicles": [ { "id": "v123", "make": "Tesla", "model": "Model 3", "year": 2023, "health_score": 92 } ] }

GET /vehicles/{id}/health

Get comprehensive health report for a vehicle

{ "health_score": 92, "engine": { "temperature": 98, "status": "optimal" }, "battery": { "health": 87, "voltage": 12.4 } }

GET /vehicles/{id}/alerts

Get predictive alerts for a specific vehicle

{ "alerts": [ { "id": "a456", "type": "brake_wear", "severity": "warning", "predicted_days": 21 } ] }

POST /mechanics/search

Find mechanics near user location

{ "latitude": 37.7749, "longitude": -122.4194, "radius_km": 10, "specialties": ["brake_work"] }

Webhooks

Receive real-time notifications for critical vehicle events via webhooks.

Supported Events

vehicle.health_changed

Triggered when health score changes significantly

alert.critical

Critical failure prediction detected

alert.warning

Warning-level alert generated

booking.confirmed

Mechanic booking confirmed

Webhook Payload Example

{ "event": "alert.critical", "timestamp": "2024-03-26T10:30:00Z", "vehicle_id": "v123", "data": { "alert_id": "a789", "type": "engine_failure", "predicted_days": 3 } }

Developer Support

Need help with integration? Our technical team is here to assist.