API ஆவணம்
COEkaki REST API v1 — சிங்கப்பூர் COE தரவை நிரல் ரீதியாக அணுகவும்.
அங்கீகாரம்
அனைத்து இறுதிப்புள்ளிகளும் அங்கீகரிக்கப்பட்ட மற்றும் பொது அணுகலை ஆதரிக்கின்றன. அங்கீகரிக்கப்பட்ட கோரிக்கைகள் அதிக விகித வரம்புகளைப் பெறுகின்றன.
உங்கள் API விசையை இதன் வழியாக அனுப்பவும் X-API-Key தலைப்பு. விசைகளை வினவல் அளவுருக்களாக ஒருபோதும் அனுப்ப வேண்டாம்.
curl -H "X-API-Key: your_api_key_here" \
https://coekaki.com/api/v1/results/latestகோரிக்கை வரம்புகள்
| அணுகல் நிலை | கோரிக்கை வரம்பு |
|---|---|
| பொது (API விசை இல்லை) | 100 கோரிக்கைகள்/நிமிடம் |
| அங்கீகரிக்கப்பட்டது (API விசையுடன்) | 1,000 கோரிக்கைகள்/நிமிடம் |
விகித வரம்பு நிலை இதன் மூலம் திரும்பும் X-RateLimit-* பதில் தலைப்புகள்.
பதில் வடிவம்
அனைத்து பதில்களும் JSON ஒரு சீரான அமைப்புடன் திரும்பும்:
{
"data": [ ... ],
"meta": {
"total": 50,
"page": 1,
"per_page": 50,
"last_page": 1
}
}ஒவ்வொரு பதிலிலும் ஒரு அடங்கும் X-API-Version: v1 தலைப்பு.
பிழைக் குறியீடுகள்
| HTTP நிலை | குறியீடு | விளக்கம் |
|---|---|---|
| 401 | INVALID_API_KEY | வழங்கப்பட்ட API விசை தவறானது. |
| 404 | NOT_FOUND | கோரப்பட்ட ஆதாரம் இல்லை. |
| 422 | VALIDATION_ERROR | கோரிக்கை அளவுருக்கள் சரிபார்ப்பில் தோல்வியடைந்தது. |
| 429 | RATE_LIMITED | பல கோரிக்கைகள். வேகத்தைக் குறைத்து மீண்டும் முயற்சிக்கவும். |
COE முடிவுகள்
/api/v1/results
பேஜினேஷன் மற்றும் விருப்ப வடிப்பான்களுடன் COE ஏல முடிவுகளின் பட்டியல்.
அளவுருக்கள்
| அளவுரு | வகை | விளக்கம் |
|---|---|---|
| category | string | வகையின்படி வடிகட்டவும்: A, B, C, D, அல்லது E |
| from | date | தொடக்க தேதி (YYYY-MM-DD) |
| முதல் | date | முடிவுத் தேதி (YYYY-MM-DD) |
| page | integer | பக்க எண் (இயல்புநிலை: 1) |
| per_page | integer | ஒரு பக்கத்திற்கான முடிவுகள் (அதிகபட்சம்: 200, இயல்புநிலை: 50) |
GET /api/v1/results?category=A&from=2025-01-01&to=2025-12-31/api/v1/results/latest
அனைத்து வகைகளுக்கும் மிகச் சமீபத்திய ஏல சுற்று முடிவுகளைப் பெறுங்கள்.
{
"data": [
{
"id": 1,
"bidding_date": "2026-04-09",
"bidding_round": 1,
"category": "A",
"quota_premium": 98000,
"pqp": 95000,
"bids_submitted": 2100,
"bids_successful": 1850
}
],
"meta": { "total": 5, "bidding_date": "2026-04-09" }
}/api/v1/results/{id}
ஒரு COE முடிவை அதன் எண் ஐடி மூலம் மீட்டெடுக்கவும். காணப்படவில்லை எனில் 404 ஐ வழங்கும்.
போக்குகள்
/api/v1/trends
வரலாற்று COE பிரீமியம் போக்குகள் வகை மூலம் தொகுக்கப்பட்டுள்ளன. விளக்கப்படம் தயார் தரவை வழங்குகிறது.
அளவுருக்கள்
| அளவுரு | வகை | விளக்கம் |
|---|---|---|
| months | integer | திரும்பிப் பார்க்க வேண்டிய மாதங்களின் எண்ணிக்கை (1-120, இயல்புநிலை: 12) |
| category | string | ஒற்றை வகைக்கு வடிகட்டவும்: A, B, C, D, அல்லது E |
| from | date | தொடக்க தேதி (YYYY-MM-DD) |
| முதல் | date | முடிவுத் தேதி (YYYY-MM-DD) |
/api/v1/trends/pqp
PQP (நடைபெறும் கோட்டா பிரீமியம்) பிரிமியம்-vs-PQP பரவல் உட்பட வகை வாரியாக.
வரலாற்றுத் தரவு போதாவிட்டால் அல்லது பிரிவு E ஆக இருந்தால் PQP மற்றும் அதன் விலை வித்தியாசம் null ஆக இருக்கும். E பிரிவு வாகனங்கள் பொருந்தும் A–D வாகனப் பிரிவில் COEயைப் புதுப்பிக்க வேண்டும்.
அதே அளவுருக்களை ஏற்றுக்கொள்கிறது /trends.
ஏல அட்டவணை
/api/v1/schedule
அனைத்து ஏல அட்டவணைகளையும் பட்டியலிடுங்கள், மிகச் சமீபத்திய முதல் வரிசைப்படுத்தப்பட்டவை.
/api/v1/schedule/upcoming
இன்னும் தொடங்காத வரவிருக்கும் ஏலச் சுற்றுகள்.
/api/v1/schedule/current
தற்போதைய நேரடி ஏல சுற்று, ஏதேனும் இருந்தால். திரும்புகிறது data: null எந்த ஏலச் சுற்றுயும் நேரலையில் இல்லாதபோது.
{
"data": null,
"meta": {
"is_live": false,
"message": "No bidding exercise is currently live."
}
}பதிவு நீக்கம்
/api/v1/deregistrations
வடிகட்டிகள் மற்றும் பேஜினேஷனுடன் வாகனப் பதிவு நீக்கத் தரவைப் பட்டியலிடவும்.
அளவுருக்கள்
| அளவுரு | வகை | விளக்கம் |
|---|---|---|
| category | string | வகையின்படி வடிகட்டவும்: A, B, C, D, அல்லது E |
| from | date | தொடக்க தேதி (YYYY-MM-DD) |
| முதல் | date | முடிவுத் தேதி (YYYY-MM-DD) |
| per_page | integer | ஒரு பக்கத்திற்கான முடிவுகள் (அதிகபட்சம்: 200, இயல்புநிலை: 50) |
/api/v1/deregistrations/latest
அனைத்து வகைகளுக்கான சமீபத்திய மாதத்தின் பதிவு நீக்கம் தரவு (அல்லது வடிகட்டுதல் category).
COE ஒதுக்கீடுகள்
/api/v1/quotas
காலாண்டு COE ஒதுக்கீடு ஒதுக்கீடுகளை பேஜினேஷன் மற்றும் ஃபில்டர்களுடன் பட்டியலிடுங்கள்.
அளவுருக்கள்
| அளவுரு | வகை | விளக்கம் |
|---|---|---|
| category | string | வகையின்படி வடிகட்டவும்: A, B, C, D, அல்லது E |
| from | date | காலாண்டு தொடக்கத்திற்கான தொடக்கத் தேதி (YYYY-MM-DD) |
| முதல் | date | காலாண்டு தொடக்கத்திற்கான இறுதித் தேதி (YYYY-MM-DD) |
| per_page | integer | ஒரு பக்கத்திற்கான முடிவுகள் (அதிகபட்சம்: 200, இயல்புநிலை: 50) |
/api/v1/quotas/latest
நடப்பு காலாண்டின் COE ஒதுக்கீடு ஒதுக்கீடுகள். தற்போதைய தரவு இன்னும் கிடைக்கவில்லை என்றால், மிகச் சமீபத்திய காலாண்டிற்குத் திரும்பும்.
PQP வரலாறு
/api/v1/pqp
PQP (நடைபெறும் ஒதுக்கீடு பிரீமியம்) பிரீமியம்-vs-PQP ஒவ்வொரு முடிவுக்கும் பரவிய வரலாறு.
வரலாற்றுத் தரவு போதாவிட்டால் அல்லது பிரிவு E ஆக இருந்தால் PQP மற்றும் அதன் விலை வித்தியாசம் null ஆக இருக்கும். E பிரிவு வாகனங்கள் பொருந்தும் A–D வாகனப் பிரிவில் COEயைப் புதுப்பிக்க வேண்டும்.
அளவுருக்கள்
| அளவுரு | வகை | விளக்கம் |
|---|---|---|
| category | string | வகையின்படி வடிகட்டவும்: A, B, C, D, அல்லது E |
| from | date | தொடக்க தேதி (YYYY-MM-DD) |
| முதல் | date | முடிவுத் தேதி (YYYY-MM-DD) |
| per_page | integer | ஒரு பக்கத்திற்கான முடிவுகள் (அதிகபட்சம்: 200, இயல்புநிலை: 50) |
{
"data": [
{
"id": 1,
"bidding_date": "2026-04-09",
"bidding_round": 1,
"category": "A",
"pqp": 95000,
"quota_premium": 98000,
"premium_vs_pqp": 3000
}
],
"meta": { "total": 50, "page": 1, "per_page": 50, "last_page": 1 }
}