Introducción
Esta API expone la tabla ruc de la base de datos cardozoco_RUC. Todos los endpoints aceptan únicamente el método GET. La URL base es siempre la misma; el comportamiento cambia con el parámetro accion.
No requiere token, API key ni ningún tipo de autenticación. Las respuestas incluyen cabeceras CORS para que puedas consumir la API desde cualquier dominio o framework.
Endpoints
| Parámetro | Tipo | Descripción | Estado |
|---|---|---|---|
| accion | string | Debe ser listar | REQUERIDO |
| pagina | integer | Número de página (default: 1) | OPCIONAL |
| limite | integer | Registros por página, máx. 100 (default: 20) | OPCIONAL |
GET /api.php?accion=listar&pagina=1&limite=20
| Parámetro | Tipo | Descripción | Estado |
|---|---|---|---|
| accion | string | Debe ser buscar | REQUERIDO |
| ruc | string | Número de RUC exacto | REQUERIDO |
GET /api.php?accion=buscar&ruc=80000001-1
| Parámetro | Tipo | Descripción | Estado |
|---|---|---|---|
| accion | string | Debe ser buscar | REQUERIDO |
| razon | string | Texto parcial a buscar en la razón social | REQUERIDO |
| pagina | integer | Número de página (default: 1) | OPCIONAL |
| limite | integer | Registros por página, máx. 100 (default: 20) | OPCIONAL |
GET /api.php?accion=buscar&razon=CARDOZO&pagina=1&limite=20
Retorna la estructura de la tabla ruc con los tipos de datos de cada columna. Útil para conocer los campos disponibles antes de hacer consultas.
GET /api.php?accion=info
Ejemplos de código
JavaScript (fetch)
const ruc = '80000001-1';
const url = `https://ruc.cardozopico.com/api.php?accion=buscar&ruc=${ruc}`;
fetch(url)
.then(res => res.json())
.then(data => {
if (data.status === 'ok') {
console.log(data.data);
}
})
.catch(err => console.error(err));
PHP
$ruc = '80000001-1';
$url = 'https://ruc.cardozopico.com/api.php?accion=buscar&ruc=' . urlencode($ruc);
$response = file_get_contents($url);
$data = json_decode($response, true);
if ($data['status'] === 'ok') {
print_r($data['data']);
}
Python
import requests
url = 'https://ruc.cardozopico.com/api.php'
params = {'accion': 'buscar', 'ruc': '80000001-1'}
r = requests.get(url, params=params)
data = r.json()
if data['status'] == 'ok':
print(data['data'])
Respuesta JSON típica (buscar por RUC)
{
"status": "ok",
"data": {
"ruc": "80000001-1",
"razon_social": "NOMBRE CONTRIBUYENTE S.A.",
...
}
}
Respuestas HTTP
Todas las respuestas contienen un campo status con valores "ok", "not_found" o "error". En caso de error se incluye el campo mensaje con la descripción.
Tester en línea
Prueba la API directamente desde el navegador sin necesidad de herramientas externas.
Los resultados aparecerán aquí...