Documentación Lichcards

Asistentes de IA & API

Encuentra cartas coleccionables, cartas sueltas, accesorios y juegos de mesa con datos actualizados. Esta guía ayuda a desarrolladores y asistentes de IA a buscar en nuestra tienda e interpretar correctamente la información.

  • Datos públicos de productos
  • Lectura sin clave API
  • Comercio Shopify

Primeros pasos

Busca primero un producto y consulta después la variante elegida. La página del producto muestra especificaciones, contenido, idioma y estado de las cartas.

Buscar productos

GET /es/search/suggest.json?q=pokemon&resources%5Btype%5D=product&resources%5Blimit%5D=3

Leer productos y variantes

GET /es/products/151-caja-de-mazos-de-coleccion-ultra-premium.js

Leer la moneda de tu sesión

GET /es/cart.js

La especificación OpenAPI describe solicitudes existentes de Shopify. Las instrucciones para agentes y el descubrimiento UCP siguen siendo la fuente de las funciones comerciales actuales.

Idioma, país y precios

Mantén el mismo idioma y país en todas las solicitudes. Una URL en inglés no selecciona automáticamente el envío al Reino Unido. Los importes de la API de productos .js se expresan en centésimas: 295 significa 2,95 en la moneda activa. Las sugerencias de búsqueda usan cadenas decimales. Consulta la moneda en tu propia sesión /cart.js. El envío, posibles descuentos y total se determinan al finalizar la compra.

Acceso y funciones

Las tres solicitudes GET de esta especificación OpenAPI no requieren clave API. Leen productos públicos y resultados de búsqueda, o únicamente tu propia sesión del carrito. No dan acceso a datos de clientes, pedidos, pagos ni administración. La especificación no contiene operaciones de escritura.

Gestionar errores

Comprueba siempre el estado HTTP antes de analizar JSON. Los parámetros de búsqueda inválidos devuelven un error JSON con status, message y description. Un producto desconocido puede devolver una respuesta 404 vacía: busca el producto correcto. Espera ante un 429 y respeta Retry-After cuando exista.

{
  "status": 422,
  "message": "Invalid parameter error",
  "description": "Type not supported."
}

Compras a través de Shopify

Shopify publica las funciones actuales mediante UCP. Lee primero el documento de descubrimiento y sigue los servicios, versiones y requisitos de autenticación indicados. Al comprar, utiliza la variante elegida, el país y la moneda del comprador; el pago requiere su autorización.

Descubrimiento UCP