Autenticacion API Camtom | API key y tokens

​

Header de autenticacion

Authorization: Bearer sk_tu_api_key

import requests

headers = {"Authorization": "Bearer sk_tu_api_key"}

response = requests.post(
    "https://api.camtomx.com/api/v3/tariffpro/tariffpro-mini",
    headers=headers,
    params={"country_code": "MEX", "model": "pro"},
    data={"product_description": "Tornillo de acero inoxidable M8x40mm"}
)

const formData = new FormData();
formData.append("product_description", "Tornillo de acero inoxidable M8x40mm");

const response = await fetch(
  "https://api.camtomx.com/api/v3/tariffpro/tariffpro-mini?country_code=MEX&model=pro",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer sk_tu_api_key"
    },
    body: formData
  }
);

curl -X POST "https://api.camtomx.com/api/v3/tariffpro/tariffpro-mini?country_code=MEX&model=pro" \
  -H "Authorization: Bearer sk_tu_api_key" \
  -F "product_description=Tornillo de acero inoxidable M8x40mm"

​

Mecanismos de autenticacion

​

API Keys

1. Se valida que la API key sea activa y que la organizacion tenga una suscripcion vigente
2. Se valida que la organizacion tenga suscripcion pro o enterprise, y que la suscripcion no este expirada

​

JWT Tokens

​

Obtener tu API key

1. Inicia sesion en app.camtomx.com
2. Ve a Settings (Configuracion) en el menu lateral
3. Selecciona la seccion API Keys
4. Haz clic en Crear nueva API key
5. Copia la key — solo se muestra una vez

​

Tipos de API key

​

Requisitos de suscripcion

• Solo pueden usar country_code=WORLD para clasificaciones
• Intentar usar otros codigos de pais devuelve 403: “Your current plan only allows access to WORLD classifications.”

​

Sistema de creditos

• Cada organizacion tiene limites de creditos definidos en su suscripcion
• Cada API key pertenece a una organizacion y comparte sus creditos
• Cada producto tiene limites de creditos definidos en tu suscripcion
• Cada llamada que consume creditos queda registrada

​

Rutas exentas de autenticacion

• Peticiones OPTIONS (CORS preflight)
• /, /api/v2, /docs, /redoc, /openapi.json, /health, /favicon.ico
• Cualquier ruta que termine en /health
• Rutas publicas de ShareLink: /api/v3/sharelink/questions/*, /api/v3/sharelink/responses/*, /api/v3/operations-sharelink/info/*

​

Seguridad

• Nunca incluyas tu API key en codigo frontend (JavaScript del navegador, apps moviles). Usa siempre un backend como intermediario.
• Usa variables de entorno para almacenar tus keys en lugar de hardcodearlas en el codigo.
• Rota tus keys periodicamente desde el panel de configuracion.
• Cancela keys comprometidas inmediatamente usando el endpoint PATCH /api/keys/cancel o desde la plataforma.

# .env
CAMTOM_API_KEY=sk_tu_api_key

# app.py
import os
import requests

api_key = os.environ["CAMTOM_API_KEY"]
headers = {"Authorization": f"Bearer {api_key}"}

// .env
CAMTOM_API_KEY=sk_tu_api_key

// app.js
const apiKey = process.env.CAMTOM_API_KEY;
const headers = { "Authorization": `Bearer ${apiKey}` };

​

Errores de autenticacion