Random User
Generate random fake user profiles for testing and prototyping. Each call returns a unique name, email address, phone number, mailing address, and avatar URL.
Descripción general
Casos de uso
- Populate test databases with realistic-looking user records
- Demo and prototype applications without real user data
- Load testing with varied user payloads
- UI mockups and design previews
Funcionalidades
Realistic names, emails, and phone numbers via jaswdr/faker
Full mailing address including street, city, state, zip, and country
Unique avatar URL per generated user (DiceBear Identicon)
Every call returns a different random user
Puntos finales de la API
Get Random User
Returns a randomly generated fake user profile.
GET
https://requiems.xyz/v1/technology/random-user
Pruébalo
Demostración en vivoSolicitud
Sending request...
Campos de respuesta
| Campo | Tipo | Descripción |
|---|---|---|
| name | string |
Full name of the generated user |
string |
Email address of the generated user | |
| phone | string |
Phone number of the generated user |
| address.street | string |
Street address |
| address.city | string |
City name |
| address.state | string |
State or region |
| address.zip | string |
Postal / ZIP code |
| address.country | string |
Country name |
| avatar | string |
URL to a unique identicon avatar for the generated user (DiceBear) |
Ejemplos de código
curl https://requiems.xyz/v1/technology/random-user \
-H "requiems-api-key: YOUR_API_KEY"
import requests
url = "https://requiems.xyz/v1/technology/random-user"
headers = {"requiems-api-key": "YOUR_API_KEY"}
response = requests.get(url, headers=headers)
user = response.json()['data']
print(f"Generated user: {user['name']} <{user['email']}>")
const response = await fetch(
'https://requiems.xyz/v1/technology/random-user',
{
headers: {
'requiems-api-key': 'YOUR_API_KEY'
}
}
);
const { data } = await response.json();
console.log(`Generated user: ${data.name} <${data.email}>`);
require 'net/http'
require 'json'
uri = URI('https://requiems.xyz/v1/technology/random-user')
request = Net::HTTP::Get.new(uri)
request['requiems-api-key'] = 'YOUR_API_KEY'
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(request)
end
user = JSON.parse(response.body)['data']
puts "Generated user: #{user['name']} <#{user['email']}>"
Respuestas de error
500
internal_error
Internal server error
Batch Generate Users
Returns multiple randomly generated fake user profiles in a single request. Each call consumes count units of quota. Maximum 50 users per request.
POST
https://requiems.xyz/v1/technology/random-user/batch
Parámetros
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| count | integer |
Obligatorio | Number of users to generate (min: 1, max: 50). |
Pruébalo
Demostración en vivoSolicitud
Number of users to generate (min: 1, max: 50).
Sending request...
Campos de respuesta
| Campo | Tipo | Descripción |
|---|---|---|
| results | array<object> |
Ordered list of generated user profiles. Same fields as the single-user endpoint. |
| total | integer |
Number of users returned. Matches the requested count. |
Ejemplos de código
curl -X POST https://requiems.xyz/v1/technology/random-user/batch \
-H "requiems-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"count": 5}'
import requests
url = "https://requiems.xyz/v1/technology/random-user/batch"
headers = {"requiems-api-key": "YOUR_API_KEY"}
response = requests.post(url, headers=headers, json={"count": 5})
users = response.json()['data']['results']
for user in users:
print(f"Generated user: {user['name']} <{user['email']}>")
const response = await fetch(
'https://requiems.xyz/v1/technology/random-user/batch',
{
method: 'POST',
headers: {
'requiems-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({ count: 5 })
}
);
const { data } = await response.json();
data.results.forEach(user => {
console.log(`Generated user: ${user.name} <${user.email}>`);
});
require 'net/http'
require 'json'
uri = URI('https://requiems.xyz/v1/technology/random-user/batch')
request = Net::HTTP::Post.new(uri)
request['requiems-api-key'] = 'YOUR_API_KEY'
request['Content-Type'] = 'application/json'
request.body = { count: 5 }.to_json
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(request)
end
users = JSON.parse(response.body)['data']['results']
users.each { |user| puts "Generated user: #{user['name']} <#{user['email']}>" }
Respuestas de error
422
validation_failed
count is missing, less than 1, or greater than 50
400
bad_request
Request body is malformed or not valid JSON
500
internal_error
Internal server error
Preguntas frecuentes
No. All data is entirely fake and randomly generated using the jaswdr/faker library. It is safe to use for testing and development without privacy concerns.
Extremely unlikely. The generator draws from large pools of names, addresses, and other fields, so collisions are rare in practice.
Yes. The avatar URL points to DiceBear's public identicon service, which generates a unique SVG based on the user's name. No API key is required.