MobilityCredentials

Socar

socar.kr

Unofficial Socar provider for zone lookup, vehicle discovery, reservations, and return status tracking.

Tier: 🥈 Silver
Reward: ₩150,000
Auth: Credentials
Operations: 4
Working now: 0 contributors
Status: Open

Scope

Targets Socar's authenticated mobile or web surface rather than a public API. The implementation must cope with session state, availability windows, and booking rules while exposing realistic car-share operations for zone search, vehicle detail lookup, reservation creation, and trip return tracking. Inputs should use real zone and car identifiers together with start and end timestamps.

Expected operations

search-zones-nearbySearch nearby zonesreadDifficulty: hard

Retrieve the Socar zone list around a coordinate pair, including service area availability and zone metadata used before selecting a vehicle.

Inputs

latnumberrequired

Acceptance criteria

Provider scaffolded from the public @apifuse/provider-sdk
All listed operations implemented with Zod/Standard Schema input & output
Each operation declares exactly one of healthCheck or healthCheckUnsupported
Real upstream fixture data included where applicable
bun run check and bun run test pass
Auth, credential, and env-secret behavior documented (no real secrets committed)

Evidence to submit

Workspace repository and main commit link
SDK version/tag and the create command used
Operation list with input/output summaries
Health coverage table per operation
bun run check and bun run test output

Ready to claim?

Submit a claim. Your workspace will be prepared after confirmation.

Claiming a bounty requires a GitHub sign-in.

Center latitude for the zone search.

lngnumberrequired

Center longitude for the zone search.

127.0300

radius_kmnumberoptional

Optional search radius in kilometers.

citystringoptional

Optional city or district filter used by the mobile UI.

Seoul

Outputs

zoneszone_idzone_namedistance_kmavailable_carsis_bookable

Acceptance

Returns zones with zone_id and available_cars for the requested coordinate center.
Includes serviceability information instead of a generic map marker list.
Filters by radius or city when those inputs are provided.

Auth required for this operation.

get-car-detailGet car detailreadDifficulty: hard

Fetch the vehicle detail payload for a specific car_id or zone-scoped vehicle, including model, pricing, fuel or battery state, and booking constraints.

Inputs

car_idstringrequired
Vehicle identifier shown in the zone detail view.
car_320144
zone_idstringoptional
Optional zone identifier when the car id is only unique within a zone.
zone_7712

Outputs

car_idzone_idcar_modelprice_per_mininsurance_optionfuel_level

reserve-carReserve carwriteDifficulty: hard

Create a Socar reservation for a chosen car with explicit start and end times, mirroring the mobile booking flow and its pricing or insurance choices.

Inputs

zone_idstringrequired
Zone identifier for the pickup location.
zone_7712
car_idstringrequired
Vehicle identifier to reserve.
car_320144
start_atdaterequired
Reservation start timestamp in local time or ISO format.
2024-07-01T09:00:00+09:00
end_atdaterequired
Reservation end timestamp in local time or ISO format.
2024-07-01T13:00:00+09:00
insurance_optionstringoptional
Selected insurance tier for the reservation.
premium

Outputs

reservation_idreservation_statusprice_per_mininsurance_optiontotal_pricestart_at

track-return-statusTrack return statusreadDifficulty: medium

Inspect an active reservation or trip to see return progress, late return warnings, and final settlement status after the vehicle is brought back.

Inputs

reservation_idstringrequired
Reservation identifier to inspect.
resv_808812

Outputs

reservation_statusreturn_deadlinelate_feecurrent_stepsettlement_status

Acceptance

Shows current_step and return_deadline for the specified reservationId.

Suggested surface — propose changes in your submission if the upstream differs.

Acceptance

Returns car_model, price_per_min, and insurance_option for the requested vehicle.
Includes state fields such as fuel_level or battery level when the vehicle supports them.
Rejects cars outside the authenticated user's service area or unavailable for booking.

Auth required for this operation.

Acceptance

Creates a reservation_id that reflects the requested car, start_at, and end_at.
Returns pricing fields including price_per_min and total_price, not just a success flag.
Rejects overlapping or expired reservation windows with a meaningful booking error.

Auth required for this operation.

Surfaces late_fee or settlement_status when the booking is overdue or closed.

Does not expose another customer's reservation data.

Auth required for this operation.