{"openapi":"3.1.0","info":{"title":"Matrimony: cotizador para asistentes de IA","version":"1.0.0","description":"Herramientas de solo lectura de Matrimony, joyería de la Ciudad de México que fabrica a pedido anillos de compromiso, argollas de matrimonio, churumbelas y dijes de oro (iniciales y collar con nombre). Para cualquier precio usa cotizar: no estimes, no redondees y no reutilices el precio de otra configuración. Si cotizar responde faltan_datos, pregúntale eso a la persona antes de volver a cotizar. Los precios son en pesos mexicanos para entrega en México; la respuesta dice si incluyen IVA. Entrega siempre la url_3d junto con el precio y repite la configuración tal como viene en la respuesta. Si la persona no sabe su talla (anillos y churumbelas), cotiza sin talla (se usa 7) y aclara que puede cambiar. Para comprar anillos, argollas y churumbelas, la persona aparta con 30 % en el sitio o habla con un asesor (contacto). Estas herramientas no cobran, no reservan y no piden datos personales (el nombre del collar solo se usa para cotizar). Dijes y collar con nombre: solo en oro amarillo, oro10k u oro14k, con la cadena incluida en el precio; no llevan talla ni grabado, no hay anticipo en línea y un asesor cierra el pedido por WhatsApp (contacto). El nombre del collar nunca va en una liga. También disponible como servidor MCP en https://matrimony.mx/mcp.","contact":{"name":"Matrimony","url":"https://matrimony.mx/ia"}},"servers":[{"url":"https://matrimony.mx/ia/v1"}],"paths":{"/disenos":{"get":{"operationId":"listar_disenos","summary":"Listar diseños","description":"Lista los diseños públicos de Matrimony (anillos de compromiso, argollas de matrimonio, churumbelas, dijes de inicial y collar con nombre) con descripción, foto, precio \"desde\" en pesos mexicanos y liga a su ficha. Úsala para conocer los ids.","parameters":[{"name":"categoria","in":"query","required":false,"description":"anillo (de compromiso), argolla (de matrimonio), churumbela o dije (inicial o collar con nombre).","schema":{"type":"string","enum":["anillo","argolla","churumbela","dije"]}},{"name":"fuente","in":"query","required":false,"description":"Opcional: el asistente que llama (para atribución).","schema":{"type":"string","enum":["chatgpt","claude","gemini","perplexity","copilot","otro"]}}],"responses":{"200":{"description":"Respuesta exitosa (JSON).","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Parámetros inválidos.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"codigo":{"type":"string","description":"parametros_invalidos, diseno_no_encontrado, faltan_datos, valor_no_disponible, no_cotizable, limite_alcanzado, servicio_apagado, servicio_saturado o error_interno."},"mensaje":{"type":"string","description":"Explicación en español que se puede repetir a la persona."}},"required":["codigo","mensaje"]}}}}}},"404":{"description":"El diseño no existe o no es público.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"codigo":{"type":"string","description":"parametros_invalidos, diseno_no_encontrado, faltan_datos, valor_no_disponible, no_cotizable, limite_alcanzado, servicio_apagado, servicio_saturado o error_interno."},"mensaje":{"type":"string","description":"Explicación en español que se puede repetir a la persona."}},"required":["codigo","mensaje"]}}}}}},"422":{"description":"Faltan datos o la combinación no existe (incluye las opciones válidas).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"codigo":{"type":"string","description":"parametros_invalidos, diseno_no_encontrado, faltan_datos, valor_no_disponible, no_cotizable, limite_alcanzado, servicio_apagado, servicio_saturado o error_interno."},"mensaje":{"type":"string","description":"Explicación en español que se puede repetir a la persona."}},"required":["codigo","mensaje"]}}}}}},"429":{"description":"Límite diario alcanzado.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"codigo":{"type":"string","description":"parametros_invalidos, diseno_no_encontrado, faltan_datos, valor_no_disponible, no_cotizable, limite_alcanzado, servicio_apagado, servicio_saturado o error_interno."},"mensaje":{"type":"string","description":"Explicación en español que se puede repetir a la persona."}},"required":["codigo","mensaje"]}}}}}},"503":{"description":"Servicio apagado o saturado.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"codigo":{"type":"string","description":"parametros_invalidos, diseno_no_encontrado, faltan_datos, valor_no_disponible, no_cotizable, limite_alcanzado, servicio_apagado, servicio_saturado o error_interno."},"mensaje":{"type":"string","description":"Explicación en español que se puede repetir a la persona."}},"required":["codigo","mensaje"]}}}}}}}}},"/disenos/{diseno}/opciones":{"get":{"operationId":"opciones_de_diseno","summary":"Opciones de un diseño","description":"Opciones de un diseño con los valores exactos que acepta cotizar: metales, colores, piedras, formas y quilates, engastes, brazos, perfiles, anchos, looks, tallas, letras, estilos, cadenas y largos, más configuraciones de ejemplo.","parameters":[{"name":"diseno","in":"path","required":true,"description":"Id del diseño, de listar_disenos (p. ej. \"olivia\", \"a-tu-medida\", \"alba\").","schema":{"type":"string"}},{"name":"fuente","in":"query","required":false,"description":"Opcional: el asistente que llama (para atribución).","schema":{"type":"string","enum":["chatgpt","claude","gemini","perplexity","copilot","otro"]}}],"responses":{"200":{"description":"Respuesta exitosa (JSON).","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Parámetros inválidos.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"codigo":{"type":"string","description":"parametros_invalidos, diseno_no_encontrado, faltan_datos, valor_no_disponible, no_cotizable, limite_alcanzado, servicio_apagado, servicio_saturado o error_interno."},"mensaje":{"type":"string","description":"Explicación en español que se puede repetir a la persona."}},"required":["codigo","mensaje"]}}}}}},"404":{"description":"El diseño no existe o no es público.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"codigo":{"type":"string","description":"parametros_invalidos, diseno_no_encontrado, faltan_datos, valor_no_disponible, no_cotizable, limite_alcanzado, servicio_apagado, servicio_saturado o error_interno."},"mensaje":{"type":"string","description":"Explicación en español que se puede repetir a la persona."}},"required":["codigo","mensaje"]}}}}}},"422":{"description":"Faltan datos o la combinación no existe (incluye las opciones válidas).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"codigo":{"type":"string","description":"parametros_invalidos, diseno_no_encontrado, faltan_datos, valor_no_disponible, no_cotizable, limite_alcanzado, servicio_apagado, servicio_saturado o error_interno."},"mensaje":{"type":"string","description":"Explicación en español que se puede repetir a la persona."}},"required":["codigo","mensaje"]}}}}}},"429":{"description":"Límite diario alcanzado.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"codigo":{"type":"string","description":"parametros_invalidos, diseno_no_encontrado, faltan_datos, valor_no_disponible, no_cotizable, limite_alcanzado, servicio_apagado, servicio_saturado o error_interno."},"mensaje":{"type":"string","description":"Explicación en español que se puede repetir a la persona."}},"required":["codigo","mensaje"]}}}}}},"503":{"description":"Servicio apagado o saturado.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"codigo":{"type":"string","description":"parametros_invalidos, diseno_no_encontrado, faltan_datos, valor_no_disponible, no_cotizable, limite_alcanzado, servicio_apagado, servicio_saturado o error_interno."},"mensaje":{"type":"string","description":"Explicación en español que se puede repetir a la persona."}},"required":["codigo","mensaje"]}}}}}}}}},"/cotizar":{"get":{"operationId":"cotizar","summary":"Cotizar una configuración","description":"Precio exacto de una configuración, calculado con el mismo motor que la tienda: total en pesos mexicanos (dice si incluye IVA), anticipo, qué incluye, tiempos de fabricación y envío, liga al configurador 3D y liga de WhatsApp con la cotización. Si falta algo que mueve el precio responde faltan_datos con las opciones. Dijes y collar: la cadena va incluida; no llevan talla, grabado ni anticipo, y el collar pide el nombre.","parameters":[{"name":"diseno","in":"query","required":true,"description":"Id del diseño, de listar_disenos (p. ej. \"olivia\", \"a-tu-medida\", \"alba\").","schema":{"type":"string"}},{"name":"fuente","in":"query","required":false,"description":"Opcional: el asistente que llama (para atribución).","schema":{"type":"string","enum":["chatgpt","claude","gemini","perplexity","copilot","otro"]}},{"name":"metal","in":"query","required":false,"description":"oro9k, oro10k, oro14k, oro18k o platino. Dijes y collar: oro10k u oro14k.","schema":{"type":"string"}},{"name":"color","in":"query","required":false,"description":"Color del oro: amarillo, blanco o rosa. Dijes y collar: solo amarillo.","schema":{"type":"string"}},{"name":"piedra","in":"query","required":false,"description":"circonia, moissanita, diamante_laboratorio o diamante_natural. Inicial cursiva con piedra: el tipo de la piedra (opciones_de_diseno).","schema":{"type":"string"}},{"name":"forma","in":"query","required":false,"description":"Forma de la piedra (anillo o churumbela), p. ej. redondo, oval, princess, emerald, pear. Las válidas por diseño están en opciones_de_diseno.","schema":{"type":"string"}},{"name":"ct","in":"query","required":false,"description":"Anillo: quilates de la piedra principal (p. ej. 0.5, 1.0, 1.5); dependen de la forma.","schema":{"type":"string"}},{"name":"colorDiamante","in":"query","required":false,"description":"Anillo con diamante natural: color D a J (sin él, H).","schema":{"type":"string"}},{"name":"claridad","in":"query","required":false,"description":"Anillo con diamante natural: claridad VVS, VS o SI (sin ella, VS).","schema":{"type":"string"}},{"name":"engaste","in":"query","required":false,"description":"Anillo: engaste, p. ej. Garra o Bisel (solo si el diseño tiene más de uno).","schema":{"type":"string"}},{"name":"brazo","in":"query","required":false,"description":"Anillo: brazo, p. ej. Liso, Uñas o Canal (solo si el diseño tiene más de uno).","schema":{"type":"string"}},{"name":"cobertura","in":"query","required":false,"description":"Anillo con brazo de pavé: cobertura de piedras del brazo (1/3, 1/2 o 3/4).","schema":{"type":"string"}},{"name":"prongs","in":"query","required":false,"description":"Anillo: color de las garras (amarillo, blanco o rosa), si es distinto al del oro.","schema":{"type":"string"}},{"name":"talla","in":"query","required":false,"description":"Anillo o churumbela: talla de 3 a 13 en medios puntos; cambia el precio. Sin ella se cotiza la 7.","schema":{"type":"string"}},{"name":"grabado","in":"query","required":false,"description":"Anillo: texto del grabado interior (máx. 30 caracteres). No cambia el precio; se ve en la liga 3D.","schema":{"type":"string"}},{"name":"look","in":"query","required":false,"description":"Argolla Clásica: estilo del catálogo (p. ej. plano-un-metal-blanco), de opciones_de_diseno.","schema":{"type":"string"}},{"name":"perfil","in":"query","required":false,"description":"Argolla Clásica sin look: plano, comfort, media_cana, redondo, recto, biselado, filo, concavo o hueco.","schema":{"type":"string"}},{"name":"ancho","in":"query","required":false,"description":"Argolla: ancho en mm (3, 4, 6, 8 o 10, según el perfil o el look).","schema":{"type":"string"}},{"name":"talla_ella","in":"query","required":false,"description":"Argolla: talla de la argolla de ella (3 a 13). Sin ella, 6.","schema":{"type":"string"}},{"name":"talla_el","in":"query","required":false,"description":"Argolla: talla de la argolla de él (3 a 13). Sin ella, 10.","schema":{"type":"string"}},{"name":"tamano","in":"query","required":false,"description":"Churumbela: tamaño de cada piedra en quilates (p. ej. 0.10). Collar con nombre: chico, mediano o grande.","schema":{"type":"string"}},{"name":"letra","in":"query","required":false,"description":"Inicial: letra de la A a la Z (sin Ñ).","schema":{"type":"string"}},{"name":"nombre","in":"query","required":false,"description":"Collar con nombre: el nombre (2 a 12 letras). Nunca va en la liga.","schema":{"type":"string"}},{"name":"estilo","in":"query","required":false,"description":"Collar con nombre: glam, firma o burbuja.","schema":{"type":"string"}},{"name":"grosor","in":"query","required":false,"description":"Collar con nombre: grosor de la placa en mm: 0.8, 1 o 1.2.","schema":{"type":"string"}},{"name":"cadena","in":"query","required":false,"description":"Inicial o collar: forzatina, rolo o cartier3x1 (sin ella, forzatina).","schema":{"type":"string"}},{"name":"largo","in":"query","required":false,"description":"Inicial o collar: largo de la cadena en cm: 40, 45 o 50 (sin él, 40).","schema":{"type":"string"}}],"responses":{"200":{"description":"Respuesta exitosa (JSON).","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Parámetros inválidos.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"codigo":{"type":"string","description":"parametros_invalidos, diseno_no_encontrado, faltan_datos, valor_no_disponible, no_cotizable, limite_alcanzado, servicio_apagado, servicio_saturado o error_interno."},"mensaje":{"type":"string","description":"Explicación en español que se puede repetir a la persona."}},"required":["codigo","mensaje"]}}}}}},"404":{"description":"El diseño no existe o no es público.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"codigo":{"type":"string","description":"parametros_invalidos, diseno_no_encontrado, faltan_datos, valor_no_disponible, no_cotizable, limite_alcanzado, servicio_apagado, servicio_saturado o error_interno."},"mensaje":{"type":"string","description":"Explicación en español que se puede repetir a la persona."}},"required":["codigo","mensaje"]}}}}}},"422":{"description":"Faltan datos o la combinación no existe (incluye las opciones válidas).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"codigo":{"type":"string","description":"parametros_invalidos, diseno_no_encontrado, faltan_datos, valor_no_disponible, no_cotizable, limite_alcanzado, servicio_apagado, servicio_saturado o error_interno."},"mensaje":{"type":"string","description":"Explicación en español que se puede repetir a la persona."}},"required":["codigo","mensaje"]}}}}}},"429":{"description":"Límite diario alcanzado.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"codigo":{"type":"string","description":"parametros_invalidos, diseno_no_encontrado, faltan_datos, valor_no_disponible, no_cotizable, limite_alcanzado, servicio_apagado, servicio_saturado o error_interno."},"mensaje":{"type":"string","description":"Explicación en español que se puede repetir a la persona."}},"required":["codigo","mensaje"]}}}}}},"503":{"description":"Servicio apagado o saturado.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"codigo":{"type":"string","description":"parametros_invalidos, diseno_no_encontrado, faltan_datos, valor_no_disponible, no_cotizable, limite_alcanzado, servicio_apagado, servicio_saturado o error_interno."},"mensaje":{"type":"string","description":"Explicación en español que se puede repetir a la persona."}},"required":["codigo","mensaje"]}}}}}}}}},"/liga-3d":{"get":{"operationId":"liga_3d","summary":"Liga al configurador 3D","description":"Liga que abre el configurador 3D de matrimony.mx en una configuración, con el precio que se verá al abrirla. Acepta configuraciones parciales: lo que falte lo pone la ficha. La liga del collar nunca lleva el nombre.","parameters":[{"name":"diseno","in":"query","required":true,"description":"Id del diseño, de listar_disenos (p. ej. \"olivia\", \"a-tu-medida\", \"alba\").","schema":{"type":"string"}},{"name":"fuente","in":"query","required":false,"description":"Opcional: el asistente que llama (para atribución).","schema":{"type":"string","enum":["chatgpt","claude","gemini","perplexity","copilot","otro"]}},{"name":"metal","in":"query","required":false,"description":"oro9k, oro10k, oro14k, oro18k o platino. Dijes y collar: oro10k u oro14k.","schema":{"type":"string"}},{"name":"color","in":"query","required":false,"description":"Color del oro: amarillo, blanco o rosa. Dijes y collar: solo amarillo.","schema":{"type":"string"}},{"name":"piedra","in":"query","required":false,"description":"circonia, moissanita, diamante_laboratorio o diamante_natural. Inicial cursiva con piedra: el tipo de la piedra (opciones_de_diseno).","schema":{"type":"string"}},{"name":"forma","in":"query","required":false,"description":"Forma de la piedra (anillo o churumbela), p. ej. redondo, oval, princess, emerald, pear. Las válidas por diseño están en opciones_de_diseno.","schema":{"type":"string"}},{"name":"ct","in":"query","required":false,"description":"Anillo: quilates de la piedra principal (p. ej. 0.5, 1.0, 1.5); dependen de la forma.","schema":{"type":"string"}},{"name":"colorDiamante","in":"query","required":false,"description":"Anillo con diamante natural: color D a J (sin él, H).","schema":{"type":"string"}},{"name":"claridad","in":"query","required":false,"description":"Anillo con diamante natural: claridad VVS, VS o SI (sin ella, VS).","schema":{"type":"string"}},{"name":"engaste","in":"query","required":false,"description":"Anillo: engaste, p. ej. Garra o Bisel (solo si el diseño tiene más de uno).","schema":{"type":"string"}},{"name":"brazo","in":"query","required":false,"description":"Anillo: brazo, p. ej. Liso, Uñas o Canal (solo si el diseño tiene más de uno).","schema":{"type":"string"}},{"name":"cobertura","in":"query","required":false,"description":"Anillo con brazo de pavé: cobertura de piedras del brazo (1/3, 1/2 o 3/4).","schema":{"type":"string"}},{"name":"prongs","in":"query","required":false,"description":"Anillo: color de las garras (amarillo, blanco o rosa), si es distinto al del oro.","schema":{"type":"string"}},{"name":"talla","in":"query","required":false,"description":"Anillo o churumbela: talla de 3 a 13 en medios puntos; cambia el precio. Sin ella se cotiza la 7.","schema":{"type":"string"}},{"name":"grabado","in":"query","required":false,"description":"Anillo: texto del grabado interior (máx. 30 caracteres). No cambia el precio; se ve en la liga 3D.","schema":{"type":"string"}},{"name":"look","in":"query","required":false,"description":"Argolla Clásica: estilo del catálogo (p. ej. plano-un-metal-blanco), de opciones_de_diseno.","schema":{"type":"string"}},{"name":"perfil","in":"query","required":false,"description":"Argolla Clásica sin look: plano, comfort, media_cana, redondo, recto, biselado, filo, concavo o hueco.","schema":{"type":"string"}},{"name":"ancho","in":"query","required":false,"description":"Argolla: ancho en mm (3, 4, 6, 8 o 10, según el perfil o el look).","schema":{"type":"string"}},{"name":"talla_ella","in":"query","required":false,"description":"Argolla: talla de la argolla de ella (3 a 13). Sin ella, 6.","schema":{"type":"string"}},{"name":"talla_el","in":"query","required":false,"description":"Argolla: talla de la argolla de él (3 a 13). Sin ella, 10.","schema":{"type":"string"}},{"name":"tamano","in":"query","required":false,"description":"Churumbela: tamaño de cada piedra en quilates (p. ej. 0.10). Collar con nombre: chico, mediano o grande.","schema":{"type":"string"}},{"name":"letra","in":"query","required":false,"description":"Inicial: letra de la A a la Z (sin Ñ).","schema":{"type":"string"}},{"name":"nombre","in":"query","required":false,"description":"Collar con nombre: el nombre (2 a 12 letras). Nunca va en la liga.","schema":{"type":"string"}},{"name":"estilo","in":"query","required":false,"description":"Collar con nombre: glam, firma o burbuja.","schema":{"type":"string"}},{"name":"grosor","in":"query","required":false,"description":"Collar con nombre: grosor de la placa en mm: 0.8, 1 o 1.2.","schema":{"type":"string"}},{"name":"cadena","in":"query","required":false,"description":"Inicial o collar: forzatina, rolo o cartier3x1 (sin ella, forzatina).","schema":{"type":"string"}},{"name":"largo","in":"query","required":false,"description":"Inicial o collar: largo de la cadena en cm: 40, 45 o 50 (sin él, 40).","schema":{"type":"string"}}],"responses":{"200":{"description":"Respuesta exitosa (JSON).","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Parámetros inválidos.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"codigo":{"type":"string","description":"parametros_invalidos, diseno_no_encontrado, faltan_datos, valor_no_disponible, no_cotizable, limite_alcanzado, servicio_apagado, servicio_saturado o error_interno."},"mensaje":{"type":"string","description":"Explicación en español que se puede repetir a la persona."}},"required":["codigo","mensaje"]}}}}}},"404":{"description":"El diseño no existe o no es público.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"codigo":{"type":"string","description":"parametros_invalidos, diseno_no_encontrado, faltan_datos, valor_no_disponible, no_cotizable, limite_alcanzado, servicio_apagado, servicio_saturado o error_interno."},"mensaje":{"type":"string","description":"Explicación en español que se puede repetir a la persona."}},"required":["codigo","mensaje"]}}}}}},"422":{"description":"Faltan datos o la combinación no existe (incluye las opciones válidas).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"codigo":{"type":"string","description":"parametros_invalidos, diseno_no_encontrado, faltan_datos, valor_no_disponible, no_cotizable, limite_alcanzado, servicio_apagado, servicio_saturado o error_interno."},"mensaje":{"type":"string","description":"Explicación en español que se puede repetir a la persona."}},"required":["codigo","mensaje"]}}}}}},"429":{"description":"Límite diario alcanzado.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"codigo":{"type":"string","description":"parametros_invalidos, diseno_no_encontrado, faltan_datos, valor_no_disponible, no_cotizable, limite_alcanzado, servicio_apagado, servicio_saturado o error_interno."},"mensaje":{"type":"string","description":"Explicación en español que se puede repetir a la persona."}},"required":["codigo","mensaje"]}}}}}},"503":{"description":"Servicio apagado o saturado.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"codigo":{"type":"string","description":"parametros_invalidos, diseno_no_encontrado, faltan_datos, valor_no_disponible, no_cotizable, limite_alcanzado, servicio_apagado, servicio_saturado o error_interno."},"mensaje":{"type":"string","description":"Explicación en español que se puede repetir a la persona."}},"required":["codigo","mensaje"]}}}}}}}}},"/contacto":{"get":{"operationId":"contacto","summary":"Contacto con un asesor","description":"Liga de WhatsApp con un asesor (con el mensaje prellenado con el diseño y la cotización, si se dan), dirección y horario del showroom en la Ciudad de México y ligas para agendar cita o videollamada. No agenda ni compra nada.","parameters":[{"name":"diseno","in":"query","required":false,"description":"Id del diseño, de listar_disenos (p. ej. \"olivia\", \"a-tu-medida\", \"alba\").","schema":{"type":"string"}},{"name":"fuente","in":"query","required":false,"description":"Opcional: el asistente que llama (para atribución).","schema":{"type":"string","enum":["chatgpt","claude","gemini","perplexity","copilot","otro"]}},{"name":"metal","in":"query","required":false,"description":"oro9k, oro10k, oro14k, oro18k o platino. Dijes y collar: oro10k u oro14k.","schema":{"type":"string"}},{"name":"color","in":"query","required":false,"description":"Color del oro: amarillo, blanco o rosa. Dijes y collar: solo amarillo.","schema":{"type":"string"}},{"name":"piedra","in":"query","required":false,"description":"circonia, moissanita, diamante_laboratorio o diamante_natural. Inicial cursiva con piedra: el tipo de la piedra (opciones_de_diseno).","schema":{"type":"string"}},{"name":"forma","in":"query","required":false,"description":"Forma de la piedra (anillo o churumbela), p. ej. redondo, oval, princess, emerald, pear. Las válidas por diseño están en opciones_de_diseno.","schema":{"type":"string"}},{"name":"ct","in":"query","required":false,"description":"Anillo: quilates de la piedra principal (p. ej. 0.5, 1.0, 1.5); dependen de la forma.","schema":{"type":"string"}},{"name":"colorDiamante","in":"query","required":false,"description":"Anillo con diamante natural: color D a J (sin él, H).","schema":{"type":"string"}},{"name":"claridad","in":"query","required":false,"description":"Anillo con diamante natural: claridad VVS, VS o SI (sin ella, VS).","schema":{"type":"string"}},{"name":"engaste","in":"query","required":false,"description":"Anillo: engaste, p. ej. Garra o Bisel (solo si el diseño tiene más de uno).","schema":{"type":"string"}},{"name":"brazo","in":"query","required":false,"description":"Anillo: brazo, p. ej. Liso, Uñas o Canal (solo si el diseño tiene más de uno).","schema":{"type":"string"}},{"name":"cobertura","in":"query","required":false,"description":"Anillo con brazo de pavé: cobertura de piedras del brazo (1/3, 1/2 o 3/4).","schema":{"type":"string"}},{"name":"prongs","in":"query","required":false,"description":"Anillo: color de las garras (amarillo, blanco o rosa), si es distinto al del oro.","schema":{"type":"string"}},{"name":"talla","in":"query","required":false,"description":"Anillo o churumbela: talla de 3 a 13 en medios puntos; cambia el precio. Sin ella se cotiza la 7.","schema":{"type":"string"}},{"name":"grabado","in":"query","required":false,"description":"Anillo: texto del grabado interior (máx. 30 caracteres). No cambia el precio; se ve en la liga 3D.","schema":{"type":"string"}},{"name":"look","in":"query","required":false,"description":"Argolla Clásica: estilo del catálogo (p. ej. plano-un-metal-blanco), de opciones_de_diseno.","schema":{"type":"string"}},{"name":"perfil","in":"query","required":false,"description":"Argolla Clásica sin look: plano, comfort, media_cana, redondo, recto, biselado, filo, concavo o hueco.","schema":{"type":"string"}},{"name":"ancho","in":"query","required":false,"description":"Argolla: ancho en mm (3, 4, 6, 8 o 10, según el perfil o el look).","schema":{"type":"string"}},{"name":"talla_ella","in":"query","required":false,"description":"Argolla: talla de la argolla de ella (3 a 13). Sin ella, 6.","schema":{"type":"string"}},{"name":"talla_el","in":"query","required":false,"description":"Argolla: talla de la argolla de él (3 a 13). Sin ella, 10.","schema":{"type":"string"}},{"name":"tamano","in":"query","required":false,"description":"Churumbela: tamaño de cada piedra en quilates (p. ej. 0.10). Collar con nombre: chico, mediano o grande.","schema":{"type":"string"}},{"name":"letra","in":"query","required":false,"description":"Inicial: letra de la A a la Z (sin Ñ).","schema":{"type":"string"}},{"name":"nombre","in":"query","required":false,"description":"Collar con nombre: el nombre (2 a 12 letras). Nunca va en la liga.","schema":{"type":"string"}},{"name":"estilo","in":"query","required":false,"description":"Collar con nombre: glam, firma o burbuja.","schema":{"type":"string"}},{"name":"grosor","in":"query","required":false,"description":"Collar con nombre: grosor de la placa en mm: 0.8, 1 o 1.2.","schema":{"type":"string"}},{"name":"cadena","in":"query","required":false,"description":"Inicial o collar: forzatina, rolo o cartier3x1 (sin ella, forzatina).","schema":{"type":"string"}},{"name":"largo","in":"query","required":false,"description":"Inicial o collar: largo de la cadena en cm: 40, 45 o 50 (sin él, 40).","schema":{"type":"string"}}],"responses":{"200":{"description":"Respuesta exitosa (JSON).","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Parámetros inválidos.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"codigo":{"type":"string","description":"parametros_invalidos, diseno_no_encontrado, faltan_datos, valor_no_disponible, no_cotizable, limite_alcanzado, servicio_apagado, servicio_saturado o error_interno."},"mensaje":{"type":"string","description":"Explicación en español que se puede repetir a la persona."}},"required":["codigo","mensaje"]}}}}}},"404":{"description":"El diseño no existe o no es público.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"codigo":{"type":"string","description":"parametros_invalidos, diseno_no_encontrado, faltan_datos, valor_no_disponible, no_cotizable, limite_alcanzado, servicio_apagado, servicio_saturado o error_interno."},"mensaje":{"type":"string","description":"Explicación en español que se puede repetir a la persona."}},"required":["codigo","mensaje"]}}}}}},"422":{"description":"Faltan datos o la combinación no existe (incluye las opciones válidas).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"codigo":{"type":"string","description":"parametros_invalidos, diseno_no_encontrado, faltan_datos, valor_no_disponible, no_cotizable, limite_alcanzado, servicio_apagado, servicio_saturado o error_interno."},"mensaje":{"type":"string","description":"Explicación en español que se puede repetir a la persona."}},"required":["codigo","mensaje"]}}}}}},"429":{"description":"Límite diario alcanzado.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"codigo":{"type":"string","description":"parametros_invalidos, diseno_no_encontrado, faltan_datos, valor_no_disponible, no_cotizable, limite_alcanzado, servicio_apagado, servicio_saturado o error_interno."},"mensaje":{"type":"string","description":"Explicación en español que se puede repetir a la persona."}},"required":["codigo","mensaje"]}}}}}},"503":{"description":"Servicio apagado o saturado.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"codigo":{"type":"string","description":"parametros_invalidos, diseno_no_encontrado, faltan_datos, valor_no_disponible, no_cotizable, limite_alcanzado, servicio_apagado, servicio_saturado o error_interno."},"mensaje":{"type":"string","description":"Explicación en español que se puede repetir a la persona."}},"required":["codigo","mensaje"]}}}}}}}}}}}