Autenticación

La API de Sendme utiliza autenticación basada en API Keys para proteger todos los endpoints.

Tipos de autenticación soportados

1. API Key (Recomendado)

Incluye tu API key en el header api-key de cada request.

GET /api/contacts
Host: app.sendme123.com
api-key: tu-api-key-aqui
Content-Type: application/json

2. JWT Bearer Token

También puedes usar un JWT Bearer token en el header de autorización.

GET /api/contacts
Host: app.sendme123.com
Authorization: Bearer tu-jwt-token-aqui
Content-Type: application/json

Obtener tu API Key

Para obtener tu API Key:

1. Regístrate en https://app.sendme123.com
2. Crea tu cuenta y verifica tu email
3. Accede al panel de administración
4. Ve a la sección de “Configuración” o “API Keys”
5. Genera tu API Key personal

Códigos de respuesta de autenticación

Código	Descripción
401	API Key faltante o inválida
403	API Key válida pero sin permisos
429	Límite de requests excedido

Ejemplos de uso

cURL

curl -X GET "https://app.sendme123.com/api/contacts" \
  -H "api-key: tu-api-key-aqui" \
  -H "Content-Type: application/json"

JavaScript

const obtenerContactos = async () => {
  try {
    const response = await axios.get('https://app.sendme123.com/api/contacts', {
      headers: {
        'api-key': 'tu-api-key-aqui',
        'Content-Type': 'application/json'
      }
    });

    console.log('Contactos obtenidos:', response.data);
    return response.data;
  } catch (error) {
    console.error('Error de autenticación:', error.response?.data || error.message);
    throw error;
  }
};

Python

import requests

headers = {
    'api-key': 'tu-api-key-aqui',
    'Content-Type': 'application/json'
}

response = requests.get('https://app.sendme123.com/api/contacts', headers=headers)
data = response.json()