Ejemplos de Uso

Ejemplo 1: Búsqueda Básica

curl -X POST "https://api.callerosint.org/callerid/search" \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "tu-token-jwt",
    "query": "34600000001"
  }'

Ejemplo 2: Python

import requests

def buscar_numero(token, numero):
    url = "https://api.callerosint.org/callerid/search"
    payload = {
        "api_key": token,
        "query": numero
    }

    response = requests.post(url, json=payload)

    if response.status_code == 200:
        data = response.json()
        print(f"✓ Búsqueda exitosa")
        print(f"Créditos restantes: {data['credits_remaining']}")
        print(f"Resultados Callapp: {data['data']['callapp']}")
        print(f"Resultados Truecaller: {data['data']['truecaller']}")
        return data
    else:
        print(f"✗ Error: {response.json()['detail']}")
        return None

# Uso
token = "tu-token-jwt"
numero = "34600000001"
resultado = buscar_numero(token, numero)

Ejemplo 3: JavaScript/Node.js

async function buscarNumero(token, numero) {
    const url = 'https://api.callerosint.org/callerid/search';

    try {
        const response = await fetch(url, {
            method: 'POST',
            headers: {
                'Content-Type': 'application/json'
            },
            body: JSON.stringify({
                api_key: token,
                query: numero
            })
        });

        const data = await response.json();

        if (response.ok) {
            console.log('✓ Búsqueda exitosa');
            console.log('Créditos restantes:', data.credits_remaining);
            console.log('Resultados:', data.data);
            return data;
        } else {
            console.error('✗ Error:', data.detail);
            return null;
        }
    } catch (error) {
        console.error('Error de conexión:', error);
        return null;
    }
}

// Uso
const token = 'tu-token-jwt';
const numero = '34600000001';
buscarNumero(token, numero);

Ejemplo 4: Manejo de Errores

import requests

def buscar_con_manejo_errores(token, numero):
    url = "https://api.callerosint.org/callerid/search"
    payload = {
        "api_key": token,
        "query": numero
    }

    try:
        response = requests.post(url, json=payload, timeout=10)

        if response.status_code == 200:
            return response.json()
        elif response.status_code == 401:
            print("Error: Token inválido")
        elif response.status_code == 403:
            print("Error: Sin créditos restantes")
        elif response.status_code == 429:
            print("Error: Rate limit excedido. Espera un minuto.")
        else:
            print(f"Error: {response.status_code} - {response.json().get('detail', 'Error desconocido')}")

    except requests.exceptions.Timeout:
        print("Error: Timeout - El servidor no respondió a tiempo")
    except requests.exceptions.RequestException as e:
        print(f"Error de conexión: {e}")

    return None

Formatos de Número

Los números deben enviarse sin el símbolo +:

Formato Incorrecto	Formato Correcto
+34600000001	34600000001
+1 555 123 4567	15551234567
+91-9876543210	919876543210

Respuesta Exitosa

{
  "success": true,
  "data": {
    "phone_number": "34600000001",
    "callapp": {
      "name": "Juan Pérez",
      "location": "Madrid, España"
    },
    "truecaller": {
      "name": "Juan Pérez",
      "spam": false
    },
    "combined": {
      "callapp_available": true,
      "truecaller_available": true
    }
  },
  "credits_remaining": 9
}