← Platform API v1.32.0

GET /tenants/{tenantId}/catalog/variant-references

Resolve authorized variant labels by up to 100 UUIDv7 IDs or 100 SKUs · General

Autenticación
SupabaseBearer · http bearer

Ejemplo

Los valores entre <> y {} son marcadores: sustitúyelos por los tuyos antes de ejecutarlo. 

curl --request GET \
  --url 'https://api.marky.ec/v1/tenants/{tenantId}/catalog/variant-references' \
  --header 'Authorization: Bearer <SupabaseBearer>'

Parámetros

Nombre En Tipo Descripción
tenantIdobligatorio path stringformato uuid
ids query stringlongitud máx. 3699 Comma-separated distinct UUIDv7 variant IDs. Unknown or foreign variants are omitted. Requires catalog.read. Exactly one of `ids` and `skus` is sent.
skus query stringlongitud máx. 10099 Comma-separated distinct SKUs, normalised as the catalogue stores them. Returns the variants that hold them, archived ones included: a SKU stays taken after its variant is archived. Unknown SKUs are omitted, so what is missing from the answer is free. Exactly one of `ids` and `skus` is sent.

Respuestas

200 Authorized workspace metadata
application/json
objectsin otras propiedades
  • itemsobligatorio
    arrayelementos máx. 100
    Cada elemento
    CatalogVariantReference
    objectsin otras propiedades

    How a variant is named wherever it is referred to: its SKU, the general name of its product and what tells its versions apart. The same fields a search result carries, so a selection read back by id is named as when it was chosen. No costs, suppliers, attributes or serials.

    • idobligatorio
      stringformato uuid
    • productIdobligatorio
      stringformato uuid
    • skuobligatorio
      string
    • productNameobligatorio
      string
    • storageobligatorio
      string | nulllongitud máx. 100
    • colorobligatorio
      string | nulllongitud máx. 100
    • simTypeobligatorio
      uno de "ESIM", "PHYSICAL_SIM", "PHYSICAL_ESIM", "DUAL_SIM", "NOT_APPLICABLE"
    • trackingModeobligatorio
      uno de "SERIALIZED", "QUANTITY", "NONE"

      How the stock of the article is kept. Only a SERIALIZED article has physical units with IMEI or serial number.

    • conditionobligatorio
      string | nulluno de "NEW", "USED", "REFURBISHED", "OPEN_BOX", "AS_IS", null

      What the SKU says its units are: the condition a new unit is proposed with. Null when the SKU states none and each unit says its own.

    • gradeobligatorio
      string | nulluno de "A", "B", "C", null

      The grade the SKU states for its units, when it states one.

401 Authentication required
403 Active membership required