Obtener contacto por ID

GET /api/contacts/:id

Obtiene un contacto específico utilizando su identificador único.

Parámetros de ruta

Parámetro	Tipo	Requerido	Descripción
id	string	Sí	ID único del contacto

Respuesta exitosa (200)

{
  "id": "contact-uuid-123",
  "name": "Juan",
  "lastName": "Pérez",
  "email": "[email protected]",
  "phone": "3001234567",
  "countryCode": "57",
  "status": "ACTIVE",
  "birthDate": "1990-01-15T00:00:00.000Z",
  "origin": "API",
  "organizationId": "org-uuid",
  "customValues": [],
  "tags": [
    {
      "id": "tag1-uuid",
      "name": "Cliente VIP",
      "description": "Clientes importantes",
      "color": "#FF5722",
      "organizationId": "org-uuid",
      "createdAt": "2024-01-01T00:00:00.000Z",
      "updatedAt": "2024-01-01T00:00:00.000Z"
    }
  ],
  "createdAt": "2024-01-01T10:00:00.000Z",
  "updatedAt": "2024-01-01T10:00:00.000Z"
}

Errores posibles

Código	Descripción
400	ID de contacto inválido
401	API Key faltante o inválida
404	Contacto no encontrado
500	Error interno del servidor

Ejemplos de uso

cURL

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

JavaScript

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

    console.log('Contacto encontrado:', response.data);
    return response.data;
  } catch (error) {
    console.error('Error obteniendo contacto:', error.response?.data || error.message);
    throw error;
  }
};

// Uso
obtenerContactoPorId('contact-uuid-123');

Python

import requests

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

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

if response.status_code == 200:
    contact = response.json()
    print('Contacto encontrado:', contact)
else:
    print('Error:', response.status_code)

Casos de uso

Verificar existencia de contacto

const contactoExiste = async (contactId) => {
  try {
    await axios.get(`https://app.sendme123.com/api/contacts/${contactId}`, {
      headers: { 'api-key': 'tu-api-key-aqui' }
    });
    return true;
  } catch (error) {
    return false;
  }
};

Obtener información completa antes de actualizar

const actualizarContactoSeguro = async (contactId, nuevosDatos) => {
  try {
    // Primero verificar que existe
    const contactoActual = await axios.get(`https://app.sendme123.com/api/contacts/${contactId}`, {
      headers: { 'api-key': 'tu-api-key-aqui' }
    });

    // Proceder con la actualización
    const response = await axios.patch(`https://app.sendme123.com/api/contacts/${contactId}`, nuevosDatos, {
      headers: {
        'api-key': 'tu-api-key-aqui',
        'Content-Type': 'application/json'
      }
    });

    console.log('Contacto actualizado:', response.data);
    return response.data;
  } catch (error) {
    if (error.response?.status === 404) {
      throw new Error('Contacto no encontrado');
    }
    console.error('Error actualizando contacto:', error.response?.data || error.message);
    throw error;
  }
};