Eliminar Cuenta
Eliminar una cuenta de cliente por ID.
Endpoint
DELETE /api/clients/{id}
Descripción
Este endpoint te permite eliminar una cuenta de cliente por su ID. Requiere autenticación con clave API.
Parámetros
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
id | string | Sí | ID del cliente (parámetro de ruta) |
Autenticación
Este endpoint requiere una clave API en el header de la solicitud:
x-api-key: TU_CLAVE_API
Respuesta
- 200 OK
- 403 Forbidden
- 404 Not Found
- 409 Conflict
{
"data": {
"message": "Cliente eliminado exitosamente"
}
}
{
"validationError": "Clave API no válida"
}
{
"validationError": "Cliente no encontrado"
}
{
"validationError": "Mensaje de error de validación"
}
Ejemplos
- cURL
- Node.js
- Python
- PHP
- Rust
curl -X DELETE "https://api.zelf.world/api/clients/client_id" \
-H "x-api-key: TU_CLAVE_API"
const axios = require('axios');
const config = {
method: 'delete',
url: 'https://api.zelf.world/api/clients/client_id',
headers: {
'x-api-key': 'TU_CLAVE_API'
}
};
axios.request(config)
.then((response) => {
console.log(JSON.stringify(response.data));
})
.catch((error) => {
console.log(error);
});
import requests
url = "https://api.zelf.world/api/clients/client_id"
headers = {
"x-api-key": "TU_CLAVE_API"
}
response = requests.delete(url, headers=headers)
print(response.json())
<?php
$url = "https://api.zelf.world/api/clients/client_id";
$options = array(
'http' => array(
'header' => "x-api-key: TU_CLAVE_API\r\n",
'method' => 'DELETE'
)
);
$context = stream_context_create($options);
$result = file_get_contents($url, false, $context);
echo $result;
?>
use reqwest;
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
let client = reqwest::Client::new();
let response = client
.delete("https://api.zelf.world/api/clients/client_id")
.header("x-api-key", "TU_CLAVE_API")
.send()
.await?;
let body = response.text().await?;
println!("{}", body);
Ok(())
}
Notas
- Requiere autenticación con clave API
- El ID del cliente debe ser válido
- Esta acción es irreversible
- Todos los datos asociados serán eliminados permanentemente
- Usar con precaución - considerar respaldo de datos antes de la eliminación