Skip to main content
La API de Camtom esta disenada para manejar volumen de produccion. Los limites dependen del tipo de endpoint y la capacidad del servicio.

​
Limites actuales

​
Endpoints de IA

Los endpoints principales de la API (TariffPro, CamtomDocs, Quoter, etc.) no tienen rate limiting global por peticiones por minuto. En su lugar, el control se realiza mediante:
  • Concurrencia: TariffPro Mini tiene un limite de 50 peticiones simultaneas por worker del servicio. Si se alcanza este limite, las peticiones adicionales esperan hasta que haya capacidad.
  • Creditos: Cada llamada consume creditos de la suscripcion de tu organizacion. Cuando los creditos se agotan, las peticiones son rechazadas.
  • Suscripcion: Solo organizaciones con suscripcion pro o enterprise pueden usar API keys.

​
Endpoints internos (Node.js - KYB)

El modulo KYB (Know Your Business) es el unico con rate limiting explicito por peticiones. Estos limites aplican a rutas internas de onboarding, no a los endpoints publicos de la API:
OperacionVentanaMax peticiones
Creacion de verificacion1 minuto5
Consultas1 minuto30
Cambios de estado1 minuto10
Verificaciones EFOS1 minuto10
Operaciones de documentos1 minuto15
Cierre de verificaciones1 minuto5
Webhooks1 minuto50
Al exceder estos limites, la respuesta es: 
{
  "error": "RATE_LIMITED",
  "message": "Too many ... requests. Try again in a minute."
}

​
Sistema de creditos como control de uso

El principal mecanismo de control de uso en la API es el sistema de creditos. Cada organizacion tiene limites definidos en su suscripcion:
RecursoComo se verifica
TariffProSegun tu plan de suscripcion
CamtomDocsPaginas procesadas cobradas (ver billed_pages en respuesta)
Digiter1 credito por archivo procesado
Quoter Meli1 credito por checkout
Cuando los creditos disponibles llegan a cero:
  • TariffPro devuelve un error indicando creditos insuficientes
  • CamtomDocs devuelve 402 CamtomDocsCreditError
Puedes consultar tu saldo de creditos desde el endpoint GET /api/v3/organization/subscription-info o desde app.camtomx.com.

​
Estrategia de reintentos

Aunque no hay rate limiting estricto en los endpoints principales, es buena practica implementar backoff exponencial para manejar errores transitorios (5xx): 
import time
import requests

def request_with_retry(url, headers, data, files=None, params=None, max_retries=5):
    for attempt in range(max_retries):
        response = requests.post(url, headers=headers, data=data, files=files, params=params)

        if response.status_code == 200:
            return response.json()

        if response.status_code == 429:
            # Limite excedido (solo aplica en ciertos endpoints)
            wait_time = 2 ** attempt
            print(f"Limite excedido. Esperando {wait_time}s (intento {attempt + 1}/{max_retries})")
            time.sleep(wait_time)
            continue

        if response.status_code >= 500:
            wait_time = 2 ** attempt  # 1s, 2s, 4s, 8s, 16s
            print(f"Error {response.status_code}. Reintentando en {wait_time}s...")
            time.sleep(wait_time)
            continue

        # Para errores 4xx (excepto 429), no reintentar
        error_body = response.json()
        raise Exception(f"Error {response.status_code}: {error_body.get('message', 'Error desconocido')}")

    raise Exception(f"Fallo despues de {max_retries} intentos")

​
Mejores practicas

​
1. Implementa caching

Si clasificas el mismo producto repetidamente, almacena el resultado en cache para evitar llamadas innecesarias y conservar creditos: 
from functools import lru_cache
import requests
import json

@lru_cache(maxsize=1000)
def classify_product(description, country_code):
    response = requests.post(
        "https://api.camtomx.com/api/v3/tariffpro/tariffpro-mini",
        headers={"Authorization": f"Bearer {api_key}"},
        params={"country_code": country_code, "model": "pro"},
        data={"product_description": description}
    )
    return json.dumps(response.json())  # lru_cache requiere tipos hashables

​
2. Controla la concurrencia

Dado que TariffPro Mini tiene un limite de 50 peticiones simultaneas por worker, controla la concurrencia de tus llamadas: 
import asyncio

semaphore = asyncio.Semaphore(20)  # Limita a 20 peticiones simultaneas

async def classify_with_limit(description, country_code):
    async with semaphore:
        return await classify_async(description, country_code)

​
3. Usa procesamiento por lotes

Para clasificar grandes volumenes de productos, considera usar los endpoints batch de TariffPro (/xlsx, /items-to-excel, /tariff-tables) que procesan multiples items en una sola peticion y devuelven un job_id para consultar el progreso.

​
4. Monitorea tus creditos

Consulta periodicamente tu saldo de creditos para evitar interrupciones: 
response = requests.get(
    "https://api.camtomx.com/api/v3/organization/subscription-info",
    headers={"Authorization": f"Bearer {api_key}"}
)
subscription = response.json()
# Revisa los limites disponibles
No intentes evadir los limites de creditos creando multiples organizaciones o cuentas. Esta practica viola los terminos de uso y puede resultar en la suspension de tu cuenta.

​
¿Necesitas más capacidad?

Si los creditos o la concurrencia de tu plan actual no son suficientes para tu caso de uso, contacta al equipo de ventas para conocer los planes Enterprise con limites personalizados:

Contactar ventas

Solicita un plan Enterprise con capacidad personalizada para tu volumen de operaciones.
Last modified on March 8, 2026