License & Developer Guide · v1.0
All endpoints are protected by API key authentication. Register an account, log in to get a token, use that token to generate an API key, then include it in every request.
Create an account using the registration form. Click the Register button in the top right, fill in your username and password, and submit.
Your password is hashed using bcrypt and never stored in plain text.
Log in using the login form. Click the Login button in the top right, enter your credentials, and submit. A JWT token is created and stored in your browser cookies for 7 days.
Your session remains active as long as your token is valid. You'll see API Keys and Logout buttons in the navbar when logged in.
Once logged in, click the API Keys button in the top right. If you haven't generated a key yet, click the Generate API Key button. Your key will be displayed once—save it immediately as you won't be able to view it again.
Note: Each account can only generate one API key.
Pass your API key in the X-API-Key header on every request.
X-API-Key: your_api_key_here
curl https://do-u-know-ball.com/endpoint \
-H "X-API-Key: your_api_key_here"