tera-api
API implementation for the TERA Online retail server (patch 92/100) on Node.js. The API consists of two independent servers running on different ports (for the needs of the portal/launcher, and separately for the needs of the Arbiter server).
Requirements
- Node.js v18.1.0
- MySQL Server v5.7.38
Installation
- Install latest node.js from https://nodejs.org/.
- Copy the all tera-api files to any directory (e.g.
c:\tera-api). - Open windows console and go to directory (type
cd c:\tera-api). - Run the
npm installfor install required node modules. - Copy or rename the
.env.examplefile to.env. - Configure the parameters in the
.envfile. - Import the database structure to your MySQL server.
- Execute the
node src/appcommand, or run the filetera-api.batto start API servers.
Important!
The account database structure used differs from that used in the leaked retail version of the server. The supported database structure is located in the share folder.
Arbiter API
It is intended for processing internal requests from the Arbiter Server, such as checking a token, receiving events about the character's behavior, etc. This API must be binded only on a local IP address and must not be accessed by external users!
Portal API
This API is a web server intended for the Launcher (portal). This API must be available from the outside (proxied by Nginx or binded on external IP) for use by server users: registration, authorization, login, update routines etc. Also, this API allows to process static elements (directory public).
API Endpoints
Arbiter Server API
| Method | Endpoint | Description |
|---|---|---|
| GET | /systemApi/RequestAPIServerStatusAvailable |
API status request. |
| POST | /authApi/GameAuthenticationLogin |
Authorization request via Arbiter server. |
| GET | /api/ServiceTest |
API and database status request. |
| POST | /api/GetUserInfo |
User information event. |
| POST | /api/EnterGame |
Game enter event. |
| POST | /api/LeaveGame |
Game leave event. |
| POST | /api/CreateChar |
Character creation event. |
| POST | /api/ModifyChar |
Character modify event. |
| POST | /api/DeleteChar |
Character delete event. |
| POST | /api/UseChronoScroll |
VIP item usage event. |
| POST | /api/report_cheater |
The event of sending a cheater report. |
Portal/Launcher API
| Method | Endpoint | Description |
|---|---|---|
| GET | /tera/ServerList?lang=%lang |
Server List request. |
| GET | /tera/LauncherMaintenanceStatus |
Request server maintenance Status. |
| GET | /tera/LauncherMain |
Get Launcher main HTML page. |
| GET | /tera/LauncherLoginForm |
Get Launcher login HTML page (login form). |
| GET | /tera/LauncherSignupForm |
Get Launcher registration HTML page (registration form). |
| POST | /tera/LauncherLoginAction |
Authorization request via Launcher. |
| POST | /tera/LauncherSignupAction |
Registration request via Launcher. |
| POST | /tera/GetAccountInfoByUserNo |
User data request. |
11 Dec 9, 2022
7 Dec 14, 2022
2 Jan 27, 2022
3 May 18, 2022
4 May 3, 2022
14 Jan 3, 2023
1 Aug 30, 2022
3 Nov 27, 2022
2 Mar 28, 2022
118 Sep 8, 2022