Documentación Oficial v1.0

ChiguiMail API

Integra la compra y consulta de cuentas Microsoft (Outlook / Hotmail) directamente desde tu aplicación o script. Toda la autenticación se hace mediante tu API Key personal.

Base URL

capi.chiguimail.com

Formato

GET / application/json

Auth

apiKey (query param)

Autenticación

Todas las peticiones requieren tu apiKey como parámetro de query. Encuéntrala en chiguimail.com/mi-cuenta → sección Acceso API.

Ejemplo

GET https://capi.chiguimail.com/api/balance?apiKey=TU_API_KEY

Errores

Todas las respuestas incluyen success y message en caso de error.

HTTP	Causa
401	API Key inválida o no enviada
402	Saldo insuficiente
400	Parámetro inválido o faltante
500	Error interno del servidor

1. Balance

GET /api/balance Consulta tu saldo disponible

https://capi.chiguimail.com/api/balance?apiKey=TU_API_KEY

Parámetros

Parámetro	Tipo	Requerido	Descripción
apiKey	string	Sí	Tu API Key de ChiguiMail

Éxito

200 OK

{
  "success": true,
  "data": {
    "balance": 25.50,
    "currency": "USD"
  }
}

Error

401
{
  "success": false,
  "message": "API Key inválida."
}

2. Stock

GET /api/stock Inventario disponible por tipo

https://capi.chiguimail.com/api/stock?apiKey=TU_API_KEY&type=outlookv1

Parámetros

Parámetro	Tipo	Requerido	Descripción
apiKey	string	Sí	Tu API Key de ChiguiMail
type	string	No	Tipo de cuenta. Ver Tipos. Si se omite, devuelve todos.

Con type

200 OK
{
  "success": true,
  "data": {
    "type": "outlookv1",
    "stock": 9286
  }
}

Sin type (todos)

200 OK
{
  "success": true,
  "data": [
    { "type": "outlookv1",    "stock": 9286 },
    { "type": "hotmailv1",    "stock": 4120 },
    { "type": "outlookv2",    "stock": 2100 },
    { "type": "hotmailv2",    "stock": 1950 },
    { "type": "outlook-prem", "stock": 832  },
    { "type": "hotmail-prem", "stock": 411  },
    { "type": "outlook-graph","stock": 580  },
    { "type": "hotmail-graph","stock": 320  }
  ]
}

3. Obtener Cuentas

GET /api/mail Compra cuentas · descuenta saldo

Esta operación descuenta saldo real de tu cuenta. Asegúrate de tener fondos antes de llamar.

https://capi.chiguimail.com/api/mail?apiKey=TU_API_KEY&type=outlookv1&quantity=5

Parámetros

Parámetro	Tipo	Requerido	Descripción
apiKey	string	Sí	Tu API Key de ChiguiMail
type	string	Sí	Tipo de cuenta. Ver Tipos
quantity	integer	Sí	Cantidad (mín 1 · máx 100)

Éxito

200 OK

{
  "success": true,
  "data": [
    "[email protected]:Pass:Token:Id",
    "[email protected]:Pass2:Token2:Id2"
  ],
  "quantity": 2,
  "new_balance": 24.95
}
// Cada cuenta: Email:Contraseña:RefreshToken:ClientId

Saldo insuficiente

402
{
  "success": false,
  "message": "Saldo insuficiente.",
  "required": 0.50,
  "balance": 0.10
}

Tipos de Cuenta

type	Nombre	Descripción
`outlookv1`	Outlook Estándar	POP3/IMAP · uso rápido
`hotmailv1`	Hotmail Estándar	POP3/IMAP · uso rápido
`outlookv2`	Outlook Estándar V2	POP3/IMAP · uso rápido
`hotmailv2`	Hotmail Estándar V2	POP3/IMAP · uso rápido
`outlook-prem`	Outlook Premium	POP3/IMAP · 3-6 meses de vida útil
`hotmail-prem`	Hotmail Premium	POP3/IMAP · 3-6 meses de vida útil
`outlook-graph`	Outlook API	POP3/IMAP/Graph · 3-6 meses de vida útil
`hotmail-graph`	Hotmail API	POP3/IMAP/Graph · 3-6 meses de vida útil

Límites de Uso

Rate Limit

60 req/min

Por API Key

Máx por petición

100 cuentas

En /api/mail

Timeout

30 seg

Por petición