DocsAPI ReferenceAuth Endpoints

Auth Endpoints

Register, login, and Google OAuth.

Register

code
POST /api/v1/auth/register
json
{
  "email": "you@example.com",
  "name": "Your Name",
  "password": "minimum8chars"
}

Response (201):

json
{
  "user": { "id": "...", "email": "...", "name": "...", "plan": "free" },
  "token": "eyJ...",
  "api_key": "sm_live_..."
}
The api_key is only returned once. Save it immediately.

Login

code
POST /api/v1/auth/login
json
{ "email": "you@example.com", "password": "yourpassword" }

Response (200):

json
{
  "user": { "id": "...", "email": "...", "plan": "free" },
  "token": "eyJ..."
}

Google OAuth

code
GET /api/v1/auth/google
  • Redirects to Google sign-in. After authentication, redirects to:
  • Browser: https://serverme.site/auth/callback?token=...
  • CLI: http://127.0.0.1:PORT/callback?token=... (when ?callback= param is passed)