👤 API de Usuarios

Una API RESTful que te permite acceder y gestionar información de usuarios como nombre, email, ubicación, estado en línea y más.

Ideal para apps sociales, paneles de administración, sistemas de mensajería o cualquier proyecto que necesite datos de usuario.

Consulta y gestiona la información de usuarios fácilmente utilizando métodos HTTP como GET, POST, PUT y DELETE.

🚀 ¡Explora y prueba todos los endpoints en segundos!
Ver colección en Postman

🔗 URL de la API

https://devsapihub.com/api-users

Puedes acceder a esta API desde cualquier cliente HTTP como Postman o directamente en el navegador.

Probar API
✅ Obtener todos los usuarios
GET /api-users GET

Devuelve un array con todos los usuarios.

🔍 Obtener un usuario por ID
GET /api-users/:id GET

Devuelve los datos de un usuario específico.

GET /api-users/1
➕ Crear nuevo usuario
POST /api-users/user POST

Envía un JSON con los datos del nuevo usuario:

{
    "name": "Urian Viera",
    "email": "urian.viera@example.com",
    "phone": "+1 202-555-0176",
    "avatar_url": "https://devsapihub.com/img-users/2.jpg",
    "birth_date": "1986-06-25",
    "gender": "male",
    "location": { "city": "Bogota", "country": "COL" },
    "address": "fontibon",
    "status": 1,
    "last_seen": "2025-04-17T18:30:00Z",
    "message": "Hey, Que haces?",
    "online": true
}

Respuesta esperada: objeto recién creado

✏️ Editar usuario existente
PUT /api-users/user/:id PUT

Envía un JSON con los nuevos datos del usuario:

{
        "id": 3,
        "name": "Amina Yusuf actualizado",
        "email": "amina.yusuf@example.com",
        "phone": "+44 7456 321789",
        "avatar_url": "https://devsapihub.com/img-users/3.jpg",
        "birth_date": "1990-11-03",
        "gender": "female",
        "location": {
        "city": "London",
        "country": "UK"
        },
        "address": "22 Queen Street, London",
        "status": 1,
        "last_seen": "2025-04-17T15:20:00Z",
        "message": "Vamos para el cine?",
        "online": true
}

Respuesta esperada: objeto actualizado

🟢 Obtener usuarios por estado online
GET /api-users/online/:status GET

Devuelve un array de usuarios que estén online o offline, según el valor booleano true o false indicado.

GET /api-users/online/true

Respuesta esperada: array de usuarios online o mensaje de error si no hay coincidencias.

🌍 Obtener usuarios por país
GET /api-users/country/:country GET

Devuelve un array de usuarios cuyo país coincida con el parámetro especificado (no distingue mayúsculas/minúsculas).

GET /api-users/country/USA

Respuesta esperada: array de usuarios del país indicado o mensaje de error si no hay coincidencias.

🗑 Eliminar usuario
DELETE /api-users/user/:id DELETE

Elimina el usuario con el ID especificado.

DELETE /api-users/2

Respuesta esperada: listado actualizado

📚 Ejemplos de Consumo

const getUsers = async () => {
    try {
        const res = await fetch("https://devsapihub.com/api-users");
        const data = await res.json();

        if (!res.ok) {
            throw new Error('Error en la respuesta de la API');
        }

        console.log(data);
    } catch (error) {
        console.error("Error al obtener los usuarios:", error.message);
    }
};

getUsers();
import requests
response = requests.get("https://devsapihub.com/api-users")
print(response.json())
import axios from "axios";
const getUsers = async () => {
    try {
        const res = await axios.get("https://devsapihub.com/api-users");
        console.log(res.data);
    } catch (error) {
        console.error("Error al obtener los usuarios:", error.message);
    }
};

getUsers();
<?php
$response = @file_get_contents('https://devsapihub.com/api-users');
$data = json_decode($response, true);

echo '<pre>';
echo $data ? print_r($data, true) : 'Error al obtener o decodificar los datos.';
echo '</pre>';
?>