Sivitas API

The problem

Researchers and developers who need Indonesian higher-education data have to work through a source that is not built for programmatic use, and that rejects plain HTTP clients coming from datacenter IP ranges.

The approach

The API is a FastAPI service modular by domain: search, institutions, study programs, lecturers, students and statistics. Its upstream client sends a complete browser header set and uses curl_cffi to perform a real Chrome TLS handshake, which is what gets a datacenter deployment through. No upstream address is hardcoded: every URL is read from the environment, and anything left blank disables its feature instead of failing at boot.

• GET /api/ reports which upstreams a running deployment actually resolved, so a bad environment can be diagnosed without reading logs.
• When a request fails, the error body names the cause: which upstreams were tried, why, and which transport was used.
• Swagger UI, ReDoc, an OpenAPI schema and an interactive web playground.

The result

Renamed from PDDikti Data Vault to Sivitas API and now at version 5.0.0, with a hosted demo at pddikti.fastapicloud.dev and a standard gateway at pddikti.rone.dev. The landing page reports the service's own status, so a degraded upstream is said plainly rather than discovered by a failing request. The most-starred of my data APIs after Rone Arena, with tests for the client, the app and the playground. It is independent and not affiliated with the data's publisher.