Unofficial Go Client SDK for retrieving higher education data from PDDikti (Pangkalan Data Pendidikan Tinggi). Currently, the data is public, but the official API and its documentation are not yet available.

$ go get -u github.com/amirhsn/go-pddikti

// Init client
client, err := pddikti.InitClient(&pddikti.ClientConfig{
	ContextTimeout: 5000,
	UseCorsPolicy:  false,
})
if err != nil {
	return err
}

searchResult, err := client.Search("181344007")
if err != nil {
	return err
}

if len(searchResult.Students) == 0 {
	return errors.New("empty data")
}

for _, student := searchResult.Students {
	fmt.Printf("Name: %s", student.Name)
	fmt.Printf("College: %s", student.College)
	fmt.Printf("Study Programme: %s", student.Programme)
	fmt.Printf("Student ID: %s", student.ID)
	fmt.Printf("Detail ID: %s \n", student.DetailID)
}

• Retrieve higher education data in real-time, as displayed on the PDDikti website.
• Configurable context timeout and the use of Origin and Referer headers for CORS.
• Supported entities:
  • Students
  • Lecturers
  • Universities / Colleges
  • Study Programs

The client must be initialized first using the InitClient() method. This method receives one parameter, which is a pointer to the configuration for the client. If the parameter is set to nil, the default configuration will be used. The default configuration consist of:

• No CORS policy
• The context timeout follows the default settings of the Go HTTP client

• Currently, information retrieved from universities using the detail ID only returns general information about the institution. Features such as the list of teaching lecturers, lecturer-to-student ratios, and other specific details are not yet handled. These features will be the focus of future development.

• PDDikti often returns a 403 error code due to an expired certificate, which can persist for more than a day. Currently, if an error occurs, it is directly returned from the PDDikti API. A circuit breaker and caching needs to be implemented in the future.
• The return data from PDDikti needs to be parsed first using regex. The regex initialization occurs in the first step with InitClient(), but the parsing process using regex still takes some time.

Open for contributions. Raise your PR regarding an issue or by initiative.

• Amir Husein - Initial work - amirhsn

MIT © Amir Husein