User Sign In

NoteThe token returned in the response should be used as a Bearer token in the Authorization header for all subsequent WebSocket connections.Http request

URL	https://nmea.geodnet.com/rover/v1/user/login
Method	POST
Format	json
Headers	Content-Type: application/json

Request example

{
    "username": "geoduser",
    "password": "geodpass"
}

Http request Body

Parameter	Example	Type	Description
username	geoduser	String	Login username
password	geodpass	String	Login password

Response parameter

Parameter	Example	Type	Description
code	0	Number	Status code
msg	Success	String	Status code description
data		Object	Data content
data.token	b2335d2cee91b9a4c05e4585...==	String	Token
data.rovers	[{id:"68a...",time:...},...]	Array	{id: Session Id, time: Create Time}

Response example

{
"code": 0,
"msg": "Success",
"data": {
  "token": "b2335d2cee91b9a4c05e4585541ce98caa7eee41871a6929fc64e2cf581d38a4.U0hBUktEUk9ORTMuMDY4NWU0OGY5ZDVhNjY1ZDVhZjVjZjdmN2Y0M2VjNzYuMTc1NTQ4NDQ5ODY3Mw==",
  "rovers": [
    { "id": "68a29126e2cc922e3a08ab57", "time": 1755230040000 },
    { "id": "78a29126e2cc922e3a08ab57", "time": 1755220040000 }
  ]
}
}

cURL

curl -X POST 'https://nmea.geodnet.com/rover/v1/user/login' \
-H 'Content-Type: application/json' \
-d '{
  "username": "geoduser",
  "password": "geodpass"
}'

The response contains data.token. Save it as an environment variable for the next steps:

• macOS/Linux: export TOKEN="..."

• Windows PowerShell: $env:TOKEN="..."