Skip to content

Authenticate via JSON body​

POST
/kosync/users/auth

Validate KoSync credentials provided as a JSON body. Returns the md5-hashed password as the userkey for subsequent sync requests. The rate limiter buckets POST attempts by the username in this body — never by x-auth-user — so a body over 8 KB, which no KOReader login sends, is refused with 413 rather than let through unbucketed.

Request Body​

application/json
JSON
{
  
"username": "string",
  
"password": "string"
}

Responses​

Authentication successful

application/json
JSON
{
  
"authorized": "string",
  
"userkey": "string"
}

Samples​