Skip to main content
Avoid sharing your screen or taking screenshots while your password is visible in the request body.

​
User Login Authentication (v3+)

Starting from API version v3 and above, Ricardoneud.com supports a modern login-based authentication system using short-lived secret tokens. This method is designed for secure, session-based access and is the default authentication method in v4 and above.

​
Endpoint

POST https://api.ricardoneud.com/v{version_number}/user/login

​
Request Body

Send the following JSON payload: 
{
  "emailOrUsername": "your username/email",
  "password": "your password",
  "sendEmail": "true"
}

​
Successful Response

A successful login returns: 
{
  "message": "Login successful",
  "userId": 123,
  "userEmail": "user@example.com",
  "secret": "UmljYXJkb05ldWQuQXBpQ29ubmVjdC0xYTJiM2M0ZDVlNmY3Zzho"
}

​
Usage

Use the secret token in the header of subsequent requests: 
Authorization: Bearer YOUR_SECRET

​
Token Behavior

  • Validity: Each token is valid for 24 hours
  • Visibility: Tokens are visible in the dashboard and can be manually revoked
  • Regeneration: New tokens can be issued at any time by re-authenticating via the same endpoint

​
Legacy Method (API Key)

The legacy API Key authentication method remains fully supported and functional across all versions.

​
Create an API Key

Follow these steps to generate a new API key:
  1. Login at Ricardoneud.com
  2. Navigate to Dashboard → API Keys
  3. Click the Create API Key button
  4. In the modal that appears:
    • Enter a descriptive name for your API key
    • Configure the desired permissions
    • Set the state to Production using the environment selector
  5. Click Generate
  6. Done! Your API key is now created
Example UI:
API Key Creation UI

​
Usage

Use the API Key in the authorization header of subsequent requests: 
Basic: YOUR_API_KEY
⌘I