Referencia de la Catalog Items API v0

Descripción general

La Selling Partner API para items del catálogo proporciona acceso programático a información sobre items en el catálogo de Amazon.

Información de versión

Versión : v0

Información del contacto

Contacto : Asistencia para desarrolladores de la API de Selling partners
URL de contacto : https://sellercentral.amazon.com/gp/mws/contactus.html

Información de licencia

Licencia : Licencia Apache 2.0
URL de la licencia : http://www.apache.org/licenses/LICENSE-2.0

Schema URI

Anfitrión : sellingpartnerapi-na.amazon.com
Schemas : HTTPS

consume

  • application/json

produce

  • application/json

Operaciones

listCatalogItems
getCatalogItem
listaCatálogoCategorías

Rutas

GET /catalog/v0/items

Operación: listCatalogItems

Descripción

A partir del 30 de septiembre de 2022, la operación listCatalogItems ya no estará disponible en la Selling Partner API para items de catálogo v0. Como alternativa, searchCatalogItems está disponible en la versión más reciente de la Referencia de la Catalog Items API v2022-04-01 . Integraciones que se basan en la operación listCatalogItems debe migrar a la operación searchCatalogItems para evitar la interrupción del servicio.
Nota: La operación listCatalogCategories no está en desuso y puede continuar llamándola.

Parámetros

TipoNombreDescripciónEsquema
QueryMarketplaceId
requerido
Un identificador de marketplace. Especifica el marketplace para el que se devuelven los items.string
QueryQuery
opcional
Palabra clave a usar para buscar items en el catálogo. Ejemplo: 'libros de harry potter'.string
QueryQueryContextId
opcional
Un identificador para el contexto dentro del cual se realizará la búsqueda dada. Un marketplace podría proporcionar mecanismos para restringir una búsqueda a un subconjunto de itemspotenciales. Por ejemplo, el marketplace minorista permite restringir las Querys a una categoría específica. El parámetro QueryContextId especifica dicho subconjunto. Si se omite, la búsqueda se realizará utilizando el contexto predeterminado del marketplace, que normalmente contendrá el mayor conjunto de elementos.string
QuerySellerSKU
opcional
Se utiliza para identificar un itemen el marketplace dado. SellerSKU está calificado por el SellerId del seller, que se incluye con cada operación que envía.string
QueryUPC
opcional
Un código de barras de 12 dígitos que se utiliza para empaques minoristas.string
QueryEAN
opcional
Un número de itemeuropeo que identifica de forma única el itemdel catálogo, el fabricante y sus atributos.string
QueryISBN
opcional
El identificador comercial único de libros utilizado para identificar libros a nivel internacional.string
QueryENE
opcional
Un número de itemjaponés que identifica de forma única el producto, el fabricante y sus atributos.string

Respuestas

Código HTTPDescripciónSchema
200Éxito.
Headers :
x-amzn-RateLimit-Limit (string): su límite de velocidad (solicitudes por segundo) para esta operación.
x-amzn-RequestId (string): identificador de referencia de solicitud único.
ListCatalogItemsResponse
400La solicitud tiene parámetros faltantes o no válidos y no se puede analizar.
Headers :
x-amzn-RateLimit-Limit (string): su límite de velocidad (solicitudes por segundo) para esta operación.
x-amzn-RequestId (string): identificador de referencia de solicitud único.
ListCatalogItemsResponse
401Indica que el acceso al recurso está prohibido. Los posibles motivos incluyen acceso denegado, no autorizado, token caducado o firma no válida.
Headers :
x-amzn-RateLimit-Limit (string): su límite de velocidad (solicitudes por segundo) para esta operación. Nota: Para este código de estado, el encabezado de límite de tasa está obsoleto y ya no se devuelve.
x-amzn-RequestId (string): identificador de referencia de solicitud único.
ListCatalogItemsResponse
403Indica que el acceso al recurso está prohibido. Los posibles motivos incluyen acceso denegado, no autorizado, token caducado o firma no válida.
Headers :
x-amzn-RequestId (string): identificador de referencia de solicitud único.
ListCatalogItemsResponse
404El recurso especificado no existe.
Headers :
x-amzn-RateLimit-Limit (string): su límite de velocidad (solicitudes por segundo) para esta operación.
x-amzn-RequestId (string): identificador de referencia de solicitud único.
ListCatalogItemsResponse
429La frecuencia de las solicitudes fue mayor a la permitida.
Headers :
x-amzn-RateLimit-Limit (string): su límite de velocidad (solicitudes por segundo) para esta operación. Nota: Para este código de estado, el encabezado de límite de tasa está obsoleto y ya no se devuelve.
x-amzn-RequestId (string): identificador de referencia de solicitud único.
ListCatalogItemsResponse
500Ocurrió una condición inesperada que impidió que el servidor cumpliera con la request.
Headers :
x-amzn-RateLimit-Limit (string): su límite de velocidad (solicitudes por segundo) para esta operación. Nota: Para este código de estado, el encabezado de límite de tasa está obsoleto y ya no se devuelve.
x-amzn-RequestId (string): identificador de referencia de solicitud único.
ListCatalogItemsResponse
503Sobrecarga temporal o mantenimiento del servidor.
Headers :
x-amzn-RateLimit-Limit (string): su límite de velocidad (solicitudes por segundo) para esta operación. Nota: Para este código de estado, el encabezado de límite de tasa está obsoleto y ya no se devuelve.
x-amzn-RequestId (string): identificador de referencia de solicitud único.
ListCatalogItemsResponse

GET /catalog/v0/items/{asin}

Operación: getCatalogItem

Descripción

A partir del 30 de septiembre de 2022, la operación getCatalogItem ya no estará disponible en la Selling Partner API para items de catálogo v0. Esta operación está disponible en la última versión de la Referencia de la Catalog Items API v2022-04-01 . Las integraciones que dependen de esta operación deben migrar a la última versión para evitar la interrupción del servicio.
Nota: La operación listCatalogCategories no está en desuso y puede continuar llamándola.

Parámetros

TipoNombreDescripciónEsquema
QueryMarketplaceId
requerido
Un identificador de marketplace. Especifica el marketplace para el item.string
Pathasin
requerido
El Amazon Standard Identification Number (ASIN) del item.string

Respuestas

Código HTTPDescripciónSchema
200Éxito.
Headers :
x-amzn-RateLimit-Limit (string): su límite de velocidad (solicitudes por segundo) para esta operación.
x-amzn-RequestId (string): identificador de referencia de solicitud único.
GetCatalogItemResponse
400La solicitud tiene parámetros faltantes o no válidos y no se puede analizar.
Headers :
x-amzn-RateLimit-Limit (string): su límite de velocidad (solicitudes por segundo) para esta operación.
x-amzn-RequestId (string): identificador de referencia de solicitud único.
GetCatalogItemResponse
401Indica que el acceso al recurso está prohibido. Los posibles motivos incluyen acceso denegado, no autorizado, token caducado o firma no válida.
Headers :
x-amzn-RateLimit-Limit (string): su límite de velocidad (solicitudes por segundo) para esta operación. Nota: Para este código de estado, el encabezado de límite de tasa está obsoleto y ya no se devuelve.
x-amzn-RequestId (string): identificador de referencia de solicitud único.
GetCatalogItemResponse
403Indica que el acceso al recurso está prohibido. Los posibles motivos incluyen acceso denegado, no autorizado, token caducado o firma no válida.
Headers :
x-amzn-RequestId (string): identificador de referencia de solicitud único.
GetCatalogItemResponse
404El recurso especificado no existe.
Headers :
x-amzn-RateLimit-Limit (string): su límite de velocidad (solicitudes por segundo) para esta operación.
x-amzn-RequestId (string): identificador de referencia de solicitud único.
GetCatalogItemResponse
429La frecuencia de las solicitudes fue mayor a la permitida.
Headers :
x-amzn-RateLimit-Limit (string): su límite de velocidad (solicitudes por segundo) para esta operación. Nota: Para este código de estado, el encabezado de límite de tasa está obsoleto y ya no se devuelve.
x-amzn-RequestId (string): identificador de referencia de solicitud único.
GetCatalogItemResponse
500Ocurrió una condición inesperada que impidió que el servidor cumpliera con la request.
Headers :
x-amzn-RateLimit-Limit (string): su límite de velocidad (solicitudes por segundo) para esta operación. Nota: Para este código de estado, el encabezado de límite de tasa está obsoleto y ya no se devuelve.
x-amzn-RequestId (string): identificador de referencia de solicitud único.
GetCatalogItemResponse
503Sobrecarga temporal o mantenimiento del servidor.
Headers :
x-amzn-RateLimit-Limit (string): su límite de velocidad (solicitudes por segundo) para esta operación. Nota: Para este código de estado, el encabezado de límite de tasa está obsoleto y ya no se devuelve.
x-amzn-RequestId (string): identificador de referencia de solicitud único.
GetCatalogItemResponse

GET /catalog/v0/categories

Operación: listCatalogCategories

Descripción

Devuelve las categorías principales a las que pertenece un item, según el ASIN o el SellerSKU especificados.

Plan de uso:

Tasa (requestes por segundo)Explosión
12

El header de respuesta x-amzn-RateLimit-Limit devuelve los límites de tarifa del plan de uso que se aplicaron a la operación solicitada, cuando estén disponibles. La tabla anterior indica la tasa predeterminada y los valores de ráfaga para esta operación. Los selling partners cuyas demandas comerciales requieren un mayor rendimiento pueden ver valores de tasa y ráfaga más altos que los que se muestran aquí. Para obtener más información, consulte Planes de uso y límites de tarifas en la Selling Partner API .

Parámetros

TipoNombreDescripciónEsquema
QueryMarketplaceId
requerido
Un identificador de marketplace. Especifica el marketplace para el item.string
QueryASIN
opcional
El Amazon Standard Identification Number (ASIN) del item.string
QuerySellerSKU
opcional
Se utiliza para identificar itemsen el marketplace dado. SellerSKU está calificado por el SellerId del seller, que se incluye con cada operación que envía.string

Respuestas

Código HTTPDescripciónSchema
200Éxito.
Headers :
x-amzn-RateLimit-Limit (string): su límite de velocidad (solicitudes por segundo) para esta operación.
x-amzn-RequestId (string): identificador de referencia de solicitud único.
ListCatalogCategoriesResponse
400La solicitud tiene parámetros faltantes o no válidos y no se puede analizar.
Headers :
x-amzn-RateLimit-Limit (string): su límite de velocidad (solicitudes por segundo) para esta operación.
x-amzn-RequestId (string): identificador de referencia de solicitud único.
ListCatalogCategoriesResponse
401Indica que el acceso al recurso está prohibido. Los posibles motivos incluyen acceso denegado, no autorizado, token caducado o firma no válida.
Headers :
x-amzn-RateLimit-Limit (string): su límite de velocidad (solicitudes por segundo) para esta operación. Nota: Para este código de estado, el encabezado de límite de tasa está obsoleto y ya no se devuelve.
x-amzn-RequestId (string): identificador de referencia de solicitud único.
ListCatalogCategoriesResponse
403Indica que el acceso al recurso está prohibido. Los posibles motivos incluyen acceso denegado, no autorizado, token caducado o firma no válida.
Headers :
x-amzn-RequestId (string): identificador de referencia de solicitud único.
ListCatalogCategoriesResponse
404El recurso especificado no existe.
Headers :
x-amzn-RateLimit-Limit (string): su límite de velocidad (solicitudes por segundo) para esta operación.
x-amzn-RequestId (string): identificador de referencia de solicitud único.
ListCatalogCategoriesResponse
429La frecuencia de las solicitudes fue mayor a la permitida.
Headers :
x-amzn-RateLimit-Limit (string): su límite de velocidad (solicitudes por segundo) para esta operación. Nota: Para este código de estado, el encabezado de límite de tasa está obsoleto y ya no se devuelve.
x-amzn-RequestId (string): identificador de referencia de solicitud único.
ListCatalogCategoriesResponse
500Ocurrió una condición inesperada que impidió que el servidor cumpliera con la request.
Headers :
x-amzn-RateLimit-Limit (string): su límite de velocidad (solicitudes por segundo) para esta operación. Nota: Para este código de estado, el encabezado de límite de tasa está obsoleto y ya no se devuelve.
x-amzn-RequestId (string): identificador de referencia de solicitud único.
ListCatalogCategoriesResponse
503Sobrecarga temporal o mantenimiento del servidor.
Headers :
x-amzn-RateLimit-Limit (string): su límite de velocidad (solicitudes por segundo) para esta operación. Nota: Para este código de estado, el encabezado de límite de tasa está obsoleto y ya no se devuelve.
x-amzn-RequestId (string): identificador de referencia de solicitud único.
ListCatalogCategoriesResponse

Definiciones

ListCatalogItemsResponse

NombreDescripciónEsquema
payload
optional
El payload para la operación listCatalogItems.ListMatchingItemsResponse
errors
optional
Se produjeron uno o más errores inesperados durante la operación listCatalogItems.Lista de errores

ListMatchingItemsResponse

NombreDescripciónEsquema
Items
optional
Una lista de items.ItemList

ItemList

Una lista de items.

Type : < Item > array

GetCatalogItemResponse

NombreDescripciónEsquema
payload
optional
Lo payload para la operación getCatalogItem..item
errors
optional
Se produjeron uno o más errores inesperados durante la operación getCatalogItem.Lista de errores

item

Un item en el catálogo de Amazon.

NombreDescripciónEsquema
Identifiers
required
Los identificadores que identifican de forma única el item.IdentifierType
AttributeSets
optional
Una lista de atributos del item.AttributeSetList
Relationships
optional
Una lista de información de relación de variación para el item.RelationshipList
SalesRankings
optional
Una lista de información de clasificación de ventas para el item por categoría.SalesRankList

IdentifierType

NombreDescripciónEsquema
MarketplaceASIN
optional
Indica que el item está identificado por MarketPlaceId y ASIN.ASINIdentifier
SKUIdentifier
optional
Indica que el item está identificado por MarketPlaceId, SellerId y SellerSKU.SellerSKUIdentifier

ASINIdentifier

NombreDescripciónEsquema
MarketplaceId
required
Un identificador de marketplace.string
ASIN
required
El Amazon Standard Identification Number (ASIN) del item.string

SellerSKUIdentifier

NombreDescripciónEsquema
MarketplaceId
required
Un identificador de marketplace.string
SellerId
required
El identificador del seller enviado para la operación.string
SellerSKU
required
La unidad de mantenimiento de existencias (SKU) del seller del item.string

AttributeSetList

Una lista de atributos para el item.

Type : < AttributeSetListType > array

AttributeSetListType

Los atributos del item.

NombreDescripciónEsquema
Actor
optional
El atributo de actor del item.< string > array
Artist
optional
El atributo de artist del item.< string > array
AspectRatio
optional
El atributo de aspect ratio del item.string
AudienceRating
optional
El atributo de audience rating del item.string
Author
optional
El atributo de author del item.< string > array
BackFinding
optional
El atributo de back finding del item.string
BandMaterialType
optional
El atributo de band material type del item.string
Binding
optional
El atributo de binding del item.string
BlurayRegion
optional
El atributo de Bluray region del item.string
Brand
optional
El atributo de brand del item.string
CeroAgeRating
optional
El atributo de CERO age rating del item.string
ChainType
optional
El atributo de chain type del item.string
ClaspType
optional
El atributo de clasp type del item.string
Color
optional
El atributo de color del item.string
CpuManufacturer
optional
El atributo de CPU manufacturer del item.string
CpuSpeed
optional
El atributo de CPU speed del item.DecimalWithUnits
CpuType
optional
El atributo de CPU type del item.string
Creator
optional
El atributo de creator del item.< CreatorType > array
Department
optional
El atributo de department del item.string
Director
optional
El atributo de director del item.< string > array
DisplaySize
optional
El atributo de display size del item.DecimalWithUnits
Edition
optional
El atributo de edition del item.string
EpisodeSequence
optional
El atributo de episode sequence del item.string
EsrbAgeRating
optional
El atributo de ESRB age rating del item.string
Feature
optional
El atributo de feature del item< string > array
Flavor
optional
El atributo de flavor del item.string
Format
optional
El atributo de format del item.< string > array
GemType
optional
El atributo de gem type del item.< string > array
Genre
optional
El atributo de genre del item.string
GolfClubFlex
optional
El atributo de golf club flex del item.string
GolfClubLoft
optional
El atributo de golf club loft del item.DecimalWithUnits
HandOrientation
optional
El atributo de hand orientation del item.string
HardDiskInterface
optional
El atributo de hard disk interface del item.string
HardDiskSize
optional
El atributo de hard disk size del item.DecimalWithUnits
HardwarePlatform
optional
El atributo de hardware platform del item.string
HazardousMaterialType
optional
El atributo de hazardous material type del item.string
ItemDimensions
optional
El atributo de item dimensions del item.DimensionType
IsAdultProduct
optional
El atributo de adult product del item.boolean
IsAutographed
optional
El atributo de autographed del item.boolean
IsEligibleForTradeIn
optional
El atributo de es eligible for trade en del item.boolean
IsMemorabilia
optional
El atributo de es memorabilia del item.boolean
IssuesPerYear
optional
El atributo de issues per year del item.string
ItemPartNumber
optional
El atributo de item part number del item.string
Label
optional
El atributo de label del item.string
Languages
optional
El atributo de languages del item.< LanguageType > array
LegalDisclaimer
optional
El atributo de legal disclaimer del item.string
ListPrice
optional
El atributo de list price del item.Price
Manufacturer
optional
El atributo de manufacturer del item.string
ManufacturerMaximumAge
optional
El atributo de manufacturer maximum age del item.DecimalWithUnits
ManufacturerMinimumAge
optional
El atributo de manufacturer minimum age del item.DecimalWithUnits
ManufacturerPartsWarrantyDescription
optional
El atributo de manufacturer parts warranty description del item.string
MaterialType
optional
El atributo de material type del item.< string > array
MaximumResolution
optional
El atributo de maximum resolution del item.DecimalWithUnits
MediaType
optional
El atributo de media type del item.< string > array
MetalStamp
optional
El atributo de metal stamp del item.string
MetalType
optional
El atributo de metal type del item.string
Model
optional
El atributo de model del item.string
NumberOfDiscs
optional
El atributo de number of discs del item.integer
NumberOfIssues
optional
El atributo de number of issues del item.integer
NumberOfItems
optional
El atributo de number of items del item.integer
NumberOfPages
optional
El atributo de number of pages del item.integer
NumberOfTracks
optional
El atributo de number of tracks del item.integer
OperatingSystem
optional
El atributo de operating system del item.< string > array
OpticalZoom
optional
El atributo de optical zoom del item.DecimalWithUnits
PackageDimensions
optional
El atributo de package dimensions del item.DimensionType
PackageQuantity
optional
El atributo de package quantity del item.integer
PartNumber
optional
El atributo de part number del item.string
PegiRating
optional
El atributo de PEGI rating del item.string
Platform
optional
El atributo de platform del item.< string > array
ProcessorCount
optional
El atributo de processor count del item.integer
ProductGroup
optional
El atributo de product group del item.string
ProductTypeName
optional
El atributo de product type name del item.string
ProductTypeSubcategory
optional
El atributo de product type subcategory del item.string
PublicationDate
optional
El atributo de publication date del item.string
Publisher
optional
El atributo de publisher del item.string
RegionCode
optional
El atributo de region code del item.string
ReleaseDate
optional
El atributo de release date del item.string
RingSize
optional
El atributo de ring size del item.string
RunningTime
optional
El atributo de running time del item.DecimalWithUnits
ShaftMaterial
optional
El atributo de shaft material del item.string
Scent
optional
El atributo de scent del item.string
SeasonSequence
optional
El atributo de season sequence del item.string
SeikodoProductCode
optional
El atributo de Seikodo product code del item.string
Size
optional
El atributo de size del item.string
SizePerPearl
optional
El atributo de size per pearl del item.string
SmallImage
optional
El atributo de small image del item.Image
Studio
optional
El atributo de studio del item.string
SubscriptionLength
optional
El atributo de subscription length del item.DecimalWithUnits
SystemMemorySize
optional
El atributo de system memory size del item.DecimalWithUnits
SystemMemoryType
optional
El atributo de system memory type del item.string
TheatricalReleaseDate
optional
El atributo de theatrical release date del item.string
Title
optional
El atributo de título del item.string
TotalDiamondWeight
optional
El atributo de total diamond weight del item.DecimalWithUnits
TotalGemWeight
optional
El atributo de total gem weight del item.DecimalWithUnits
Warranty
optional
El atributo de garantía del item.string
WeeeTaxValue
optional
El atributo de valor fiscal WEEE del item.Price

DecimalWithUnits

El valor decimal y la unidad.

NombreDescripciónEsquema
value
optional
El valor decimal.number
Units
optional
La unidad del valor decimal.string

CreatorType

El atributo de tipo de creador de un item.

NombreDescripciónEsquema
value
optional
El valor del atributo.string
Role
optional
El papel del valor.string

DimensionType

El atributo de tipo de dimensión de un item.

NombreDescripciónEsquema
Height
optional
El atributo de altura de la dimensión.DecimalWithUnits
Length
optional
El atributo de longitud de la dimensión.DecimalWithUnits
Width
optional
El atributo de ancho de la dimensión.DecimalWithUnits
Weight
optional
El atributo de peso de la dimensión.DecimalWithUnits

LanguageType

El atributo de tipo de idioma de un item.

NombreDescripciónEsquema
Name
optional
El atributo de la URL de la imagen del item.string
Type
optional
El atributo de tipo del item.string
AudioFormat
optional
El atributo de formato de audio del item.string

Image

El atributo de imagen del item.

NombreDescripciónEsquema
URL
optional
El atributo de la URL de la imagen de item.string
Height
optional
El atributo de altura de la imagen del item.DecimalWithUnits
Width
optional
El atributo de Width de imagen del elemento.DecimalWithUnits

Price

El atributo de precio del item.

NombreDescripciónEsquema
Amount
optional
La cantidad.number
CurrencyCode
optional
El código de moneda del importe.string

RelationshipList

Una lista de información de relación de variación, si corresponde para el item.

Type : < RelationshipType > array

RelationshipType

Variaciones específicas del item.

NombreDescripciónEsquema
Identifiers
optional
Los identificadores que identifican de forma única el elemento relacionado.IdentifierType
Color
optional
La variación de color del itemstring
Edition
optional
La variación de edición del item.string
Flavor
optional
La variación de sabor del item.string
GemType
optional
Las variaciones del tipo de gem type.< string > array
GolfClubFlex
optional
La variación de la flexión del palo de golf de un item.string
HandOrientation
optional
La variación de la orientación de la mano de un item.string
HardwarePlatform
optional
La variación de la plataforma de hardware de un item.string
MaterialType
optional
Las variaciones del tipo de material de un item.< string > array
MetalType
optional
La variación del tipo de metal de un item.string
Model
optional
La variación del modelo de un item.string
OperatingSystem
optional
Las variaciones del sistema operativo de un elemento.< string > array
ProductTypeSubcategory
optional
The product type subcategory variation of an item.string
RingSize
optional
La variación de la subcategoría del tipo de producto de un item.string
ShaftMaterial
optional
La variación del tamaño del anillo de un item.string
Scent
optional
La variación del material del eje de un item.string
Size
optional
La variación del aroma de un item.string
SizePerPearl
optional
El tamaño por variación de perla de un item.string
GolfClubLoft
optional
La variación de golf club loft de un item.DecimalWithUnits
TotalDiamondWeight
optional
La variación total del peso del diamante de un item.DecimalWithUnits
TotalGemWeight
optional
La variación total del peso de la gema de un item.DecimalWithUnits
PackageQuantity
optional
La variación de la cantidad del package de un item.integer
ItemDimensions
optional
La relación de las dimensiones del item de un item.DimensionType

SalesRankList

Una lista de información de clasificación de ventas para el item por categoría.

Type : < SalesRankType > array

SalesRankType

NombreDescripciónEsquema
ProductCategoryId
required
Identifica la categoría de item de la que se toma la clasificación de ventas.string
Rank
required
La clasificación de ventas del item dentro de la categoría del item.integer (int32)

ListCatalogCategoriesResponse

NombreDescripciónEsquema
payload
optional
La carga útil para la operación listCatalogCategories.ListOfCategories
errors
optional
Se produjeron uno o más errores inesperados durante la operación listCatalogCategories.Lista de errores

ListOfCategories

Type : < Categories > array

Categories

NombreDescripciónEsquema
ProductCategoryId
optional
El identificador de la categoría de producto (o browse node).string
ProductCategoryName
optional
El nombre de la categoría de producto (o browse node).string
parent
optional
La categoría de producto principal.object

ErrorList

Una lista de respuestas de error devueltas cuando una solicitud no se realiza correctamente.

Type : < Error > array

Error

Respuesta de error devuelta cuando la solicitud no tiene éxito.

NombreDescripciónEsquema
código
requerido
Un código de error que identifica el tipo de error que ocurrió.string
mensaje
requerido
Un mensaje que describe la condición de error en un formato legible por humanos.string
detalles
opcional
Información adicional que puede ayudar a la persona que llama a comprender o solucionar el problema.string