Inicio rápido
- Crea tu cuenta gratis con tu correo. El plan gratuito se activa al confirmarlo.
- Ingresa a tu panel en admin.miapi.cloud y copia tu token.
- Haz tu primera consulta. Por ejemplo, los datos de un RUC:
curl -X GET "https://miapi.cloud/v1/ruc/20000000001" \
-H "Authorization: Bearer TU_TOKEN"const respuesta = await fetch("https://miapi.cloud/v1/ruc/20000000001", {
method: "GET",
headers: {
"Authorization": "Bearer TU_TOKEN"
},
});
const datos = await respuesta.json();
console.log(datos);<?php
$ch = curl_init("https://miapi.cloud/v1/ruc/20000000001");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer TU_TOKEN"
],
]);
$datos = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($datos);import requests
respuesta = requests.get(
"https://miapi.cloud/v1/ruc/20000000001",
headers={
"Authorization": "Bearer TU_TOKEN"
},
timeout=30,
)
print(respuesta.json()) {
"success": true,
"datos": {
"ruc": "20000000001",
"razon_social": "EMPRESA DE EJEMPLO S.A.C.",
"estado": "ACTIVO",
"condicion": "HABIDO",
"domiciliado": {
"direccion": "AV. DE EJEMPLO 123",
"distrito": "LIMA",
"provincia": "LIMA",
"departamento": "LIMA",
"ubigeo": "150101"
}
}
} Autenticación
Cada petición lleva tu token en la cabecera Authorization: Bearer TU_TOKEN. El token identifica tu cuenta
y descuenta las consultas de tu plan.
- Guárdalo en una variable de entorno o en la configuración de tu servidor, nunca en el código del navegador.
- Si crees que se filtró, genera uno nuevo desde tu panel y reemplázalo en tus sistemas.
- Usa siempre
https://.
URLs base
| Servicio | URL base |
|---|---|
| Consultas (DNI, RUC, tipo de cambio, validación de comprobantes) | https://miapi.cloud/v1/ |
| Facturación electrónica, bajas, resúmenes y guías de remisión | https://miapi.cloud/apifact/ |
| Conversión de XML a PDF | https://convertir.miapi.cloud/ |
https://admin.miapi.cloud/api/whatsapp/ |
Formato de las respuestas
Las respuestas son JSON en UTF-8. Las consultas indican si salió bien con success y entregan los datos
en un objeto (por ejemplo datos o data, según el servicio; cada página de la
referencia muestra la estructura exacta con datos ficticios).
Códigos HTTP y errores
| Código | Qué significa y qué hacer |
|---|---|
200 | Todo bien. Revisa igualmente success en el cuerpo. |
400 / 422 | Datos de entrada inválidos (por ejemplo, un RUC con menos de 11 dígitos). Valida el formato antes de enviar. |
401 | Falta el token o no es válido. Revisa la cabecera Authorization. |
404 | No se encontró el documento consultado o la ruta no existe. |
429 | Superaste el límite de tu plan o de velocidad. Espera y reintenta, o sube de plan. |
5xx | Error temporal nuestro o del servicio de SUNAT. Reintenta con espera progresiva. |
Límites y planes
La cantidad de consultas y las APIs incluidas dependen de tu plan. El plan gratuito sirve para probar la integración; cuando necesites más volumen o facturación electrónica, elige un plan en precios.
Flujo de facturación electrónica
- Genera el XML del comprobante (factura, boleta o nota) con los datos de la venta. Ver API de facturación electrónica.
- Envíalo a SUNAT y guarda la CDR (constancia de recepción) que devuelve.
- Para anular, usa la comunicación de baja o una nota de crédito; las boletas se informan en el resumen diario.
- Para entregar al cliente, convierte el XML a PDF con la API de XML a PDF.
Mientras pruebas, todo funciona en modo beta de SUNAT (sin valor tributario). Para emitir comprobantes reales tu empresa pasa a producción con su certificado digital. Más contexto en la guía de facturación electrónica.
Vincula tu número escaneando un código QR desde tu panel, igual que en WhatsApp Web. Luego envías textos o archivos (por ejemplo, el PDF de una factura) con la API de WhatsApp. Respeta las políticas de WhatsApp: envía mensajes solo a clientes que lo esperan.
Buenas prácticas
- Valida antes de consultar: DNI de 8 dígitos y RUC de 11 dígitos. Ahorras consultas.
- Usa caché: los datos de un RUC o el tipo de cambio de un día no cambian a cada minuto.
- Reintenta con espera: ante errores 5xx o 429, espera 1, 2 y 4 segundos antes de reintentar.
- Pon un tiempo máximo (timeout) a tus peticiones, por ejemplo 30 segundos.
- Protege los datos personales: consulta DNI solo con una finalidad legítima y conforme a la Ley 29733.
Referencia por API
-
API DNI
Consultas · 2 endpoints -
API RUC
Consultas · 4 endpoints -
API Tipo de Cambio
Consultas · 1 endpoint -
API Validar Comprobante
Consultas · 3 endpoints -
API Facturación Electrónica
Facturación electrónica · 2 endpoints -
API Notas de Crédito y Débito
Facturación electrónica · 2 endpoints -
API Comunicación de Baja
Facturación electrónica · 4 endpoints -
API Guía de Remisión
Guías de remisión · 5 endpoints -
API XML a PDF
Consultas · 1 endpoint -
API WhatsApp
Mensajería · 3 endpoints
Preguntas frecuentes
¿Dónde obtengo mi token?
Crea tu cuenta gratis en miapi.cloud, ingresa a tu panel en admin.miapi.cloud y copia tu token. Trátalo como una contraseña: no lo publiques en el código del navegador ni en repositorios públicos.
¿Puedo llamar a la API desde el navegador?
No es recomendable, porque tu token quedaría visible. Llama a la API desde tu servidor (backend) y entrega a tu página solo los datos que necesita.
¿Qué pasa si supero el límite de mi plan?
La API responde con un error de límite (HTTP 429 o un mensaje equivalente). Puedes subir de plan desde tu panel o escribirnos por WhatsApp.
¿Hay entorno de pruebas para facturación?
Sí. La facturación electrónica funciona en modo beta (pruebas de SUNAT) hasta que tu empresa pasa a producción con su certificado digital.
Empieza gratis hoy
Crea tu cuenta gratis, copia tu token y haz tu primera consulta en minutos. Sin tarjeta de crédito.