URETICY
ÜRETICY
Developer Resources
API Documentation
Integrate with the Üreticy API with ease
Authentication
All API requests require authentication with an API key. Get your key from account settings.
Never share your API key. Use OAuth 2.0 for public applications.
cURL Example
curl -H "Authorization: Bearer YOUR_API_KEY" \
https://api.ureticy.com/v1/stations
JavaScript / Fetch Example
const response = await fetch('https://api.ureticy.com/v1/stations', {
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
}
});
API Endpoints
Base URL
https://api.ureticy.com/v1
Content Types
application/jsonapplication/x-www-form-urlencoded
Rate Limiting
API requests are limited to 100 per minute. You'll receive HTTP 429 if exceeded.
Manage Stations
List Stations
GET/stations
| Parameter | Type | Description |
|---|---|---|
page | integer | Page number (default: 1) |
limit | integer | Records per page (max: 100) |
status | string | active | inactive | error |
Success Response
{"status":"success","data":{"stations":[{"id":"station_123","name":"İstanbul-01","status":"active","connector_count":2}],"pagination":{"page":1,"total":48}}}
Start Charging
POST/stations/{id}/start
| Parameter | Required | Description |
|---|---|---|
connector_id | Yes | Connector ID |
user_id | Yes | User ID |
Transactions
GET/transactions
| Parameter | Example |
|---|---|
station_id | station_123 |
date_from | 2026-01-01 |
date_to | 2026-04-18 |
Webhooks
Get real-time notifications about important events.
Supported Events
station.connectedstation.disconnectedtransaction.startedtransaction.completederror.critical
Payload Example
{
"event": "transaction.completed",
"timestamp": "2026-04-18T10:30:00Z",
"data": {
"transaction_id": "txn_789",
"station_id": "station_123",
"energy_consumed": 15.5,
"duration_minutes": 45,
"amount": 82.50
}
}
Error Codes
| Code | Description |
|---|---|
400 | Bad request — invalid parameters |
401 | Unauthorized — API key required |
403 | Forbidden — insufficient permissions |
404 | Not found — resource doesn't exist |
429 | Too many requests — rate limit exceeded |
500 | Internal server error |
Error Response Example
HTTP 401 Unauthorized
{"status":"error","error":{"code":"INVALID_API_KEY","message":"The provided API key is invalid or expired.","timestamp":"2026-04-18T10:30:00Z"}}