Skip to content

NCU-CC/API-Documentation

Repository files navigation

API-Documentation

Documentation for National Central University API

Root URL

https://api.cc.ncu.edu.tw

Authorization

Before you making any API calls, you have to register a client at OAuth Management first. There are two situations to use our API:

  • Access resources that contains personal information :
    1. Follow the OAuth 2.0 protocol to get an access token, see documentation.
    2. Read the documentation to use access token.
  • Access resources without personal information :
    1. Get an api token from OAuth Management.
    2. Read the documentation to use api token.

Internationalization

Some NCU APIs are bilingual(zh-TW, en-US) and default to zh-TW. Use Accept-Language header to specify your language.

Encoding

All strings are encoded in UTF-8.

Endpoints

/activity/v1

/location/v1

/course/v1

/personnel/v1

/calendar/v1

/bus/v1

Error Status Code

HTTP Status Code Description
400 invalid body or parameter.
401 access a protected resource with an invalid token.
403 access a protected resource with an token from invalid client.
404 resource not found.
405 invalid request method
500 internal server error.

Problems?

If you have any problems, please file a issue or just send us pull requests. Any pull requests submitted to master branch are not allowed, please submit to develop branch. It would be appreciated that with brief descriptions and some unit tests to proof.

Format Reference

The format of this document refer to Documentation for University of Waterloo API.

License

MIT License Copyright © 2015-2015 Computer Center, National Central University

About

Documentation for National Central University API

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published