Saltar al contenido principal
Documentación

Documentación de las APIs de MiAPI Cloud

Todo lo necesario para integrar en minutos: token, primera petición, respuestas, errores y buenas prácticas.

Inicio rápido

  1. Crea tu cuenta gratis con tu correo. El plan gratuito se activa al confirmarlo.
  2. Ingresa a tu panel en admin.miapi.cloud y copia tu token.
  3. Haz tu primera consulta. Por ejemplo, los datos de un RUC:
Primera petición
curl -X GET "https://miapi.cloud/v1/ruc/20000000001" \
  -H "Authorization: Bearer TU_TOKEN"
Respuesta (datos ficticios)
{
  "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

ServicioURL 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ónhttps://miapi.cloud/apifact/
Conversión de XML a PDFhttps://convertir.miapi.cloud/
WhatsApphttps://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ódigoQué significa y qué hacer
200Todo bien. Revisa igualmente success en el cuerpo.
400 / 422Datos de entrada inválidos (por ejemplo, un RUC con menos de 11 dígitos). Valida el formato antes de enviar.
401Falta el token o no es válido. Revisa la cabecera Authorization.
404No se encontró el documento consultado o la ruta no existe.
429Superaste el límite de tu plan o de velocidad. Espera y reintenta, o sube de plan.
5xxError 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

  1. Genera el XML del comprobante (factura, boleta o nota) con los datos de la venta. Ver API de facturación electrónica.
  2. Envíalo a SUNAT y guarda la CDR (constancia de recepción) que devuelve.
  3. Para anular, usa la comunicación de baja o una nota de crédito; las boletas se informan en el resumen diario.
  4. 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.

WhatsApp

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

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.