YaasApiProductV2

TypeScript abstraction library for RAML-based REST API YaasApiProductV2.

Auto-generated using raml-typescript-generator.

Installation

npm install yaas-api-product-v2 --save

Usage

TypeScript

import {YaasApiProductV2} from 'yaas-api-product-v2';
...
constructor(..) {
  this.yaasApiProductV2 = new YaasApiProductV2({});
}

To support multiple versions of the API, it is recommended to alias the import so it can easily be mapped to a later API version - and, due to the nature of Typescript, you should be alerted on API signature changes already at compile time:

import {YaasApiProductV2 as YaasApiProduct} from 'yaas-api-product-v2';

JS (Legacy)

API skeleton as it would be produced by MuleSoft's raml-javascript-generator JS generator is shipped for reference and to ease migrations:

var YaasApiProductV2 = require('yaas-api-product-v2/leagcy.js')

var client = new YaasApiProductV2()

Options

You can set options when you initialize a client or at any time with the options property. You may also override options per request by passing an object as the last argument of request methods. For example:

client = new YaasApiProductV2({ ... })

client('GET', '/', {
  baseUri: 'https://api.eu.yaas.io/hybris/product/anotherVersion',
  headers: {
    'Content-Type': 'application/json'
  }
})

For dynamic header injection - for example required for non-standard REST services asking for custom authentication token - a provider may be defined:

client = new YaasApiProductV2({
  getHeaders: ()=>{ return(this.myToken ? {Authorization: "Bearer " + this.myToken} : {}) }
});

Base URI

By default, endpoint as defined in RAML file https://api.eu.yaas.io/hybris/product/v2 is used.

Note If supported by API provider, it is recommended to use one API version definition (i.e. RAML file and corresponding API TypeScript library) and switch endpoint based on the desired environment, for example test, qa or prod

You can override the base URI by setting the baseUri property, or initializing a client with a base URI. For example:

new YaasApiProductV2({
  baseUri: 'https://api.eu.yaas.io/hybris/product/anotherVersion',
});

Methods

All methods return an Observable wrapping a Popsicle obtained response:

tenant({ tenant }).products.get([query, [options]])

• tenant (type: string)

Get all products.

Accepted scopes:

• hybris.product_read_unpublished - required to retrieve non-public products. If not provided only published products are returned

client.tenant({ tenant }).products.get([query, [options]]).then(...)

tenant({ tenant }).products.post([body, [options]])

• tenant (type: string)

Create new product.

Accepted scopes:

• hybris.product_create - mandatory
• hybris.product_publish - required if product is created as published (by providing published flag true )

client.tenant({ tenant }).products.post([body, [options]]).then(...)

tenant({ tenant }).products.delete([body, [options]])

• tenant (type: string)

Delete all Product entities.

Accepted scopes:

• hybris.product_delete_all - mandatory

client.tenant({ tenant }).products.delete([body, [options]]).then(...)

tenant({ tenant }).products.productId({ productId }).get([query, [options]])

• tenant (type: string)
• productId (type: string)

Retrieves a single product.

YRN: urn:yaas:hybris:product:product:{tenant};{productId}

Accepted scopes:

• hybris.product_read_unpublished - required to retrieve non-public product

client.tenant({ tenant }).products.productId({ productId }).get([query, [options]]).then(...)

tenant({ tenant }).products.productId({ productId }).put([body, [options]])

• tenant (type: string)
• productId (type: string)

Update a single product.

Accepted scopes:

• hybris.product_update - required to update product data
• hybris.product_publish - required to publish the product (by setting published flag to true)
• hybris.product_unpublish - required to unpublish the product (by setting published flag to false)

client.tenant({ tenant }).products.productId({ productId }).put([body, [options]]).then(...)

tenant({ tenant }).products.productId({ productId }).delete([body, [options]])

• tenant (type: string)
• productId (type: string)

Delete a single Product entity.

Accepted scopes:

• hybris.product_delete - mandatory

client.tenant({ tenant }).products.productId({ productId }).delete([body, [options]]).then(...)

tenant({ tenant }).products.productId({ productId }).media.post([body, [options]])

• tenant (type: string)
• productId (type: string)

Initialize process of creating new media file for product

Accepted scopes:

• hybris.product_update - mandatory

client.tenant({ tenant }).products.productId({ productId }).media.post([body, [options]]).then(...)

tenant({ tenant }).products.productId({ productId }).media.get([query, [options]])

• tenant (type: string)
• productId (type: string)

Return metadata of media files. The list is ordered according to the "position" attribute set in the file metadata.

Accepted scopes:

• hybris.product_read_unpublished - required to retrieve media metadata of non-public product

client.tenant({ tenant }).products.productId({ productId }).media.get([query, [options]]).then(...)

tenant({ tenant }).products.productId({ productId }).media.mediaId({ mediaId }).get([query, [options]])

• tenant (type: string)
• productId (type: string)
• mediaId (type: string)

Return media file metadata by ID.

YRN: urn:yaas:hybris:product:product-media:{tenant};{productId};{mediaId}

Accepted scope:

• hybris.product_read_unpublished - to retrieve media metadata of non-public product

client.tenant({ tenant }).products.productId({ productId }).media.mediaId({ mediaId }).get([query, [options]]).then(...)

tenant({ tenant }).products.productId({ productId }).media.mediaId({ mediaId }).put([body, [options]])

• tenant (type: string)
• productId (type: string)
• mediaId (type: string)

Update media file metadata. Note that only part of the metadata field can be updated.

Accepted scopes:

• hybris.product_update - mandatory

client.tenant({ tenant }).products.productId({ productId }).media.mediaId({ mediaId }).put([body, [options]]).then(...)

tenant({ tenant }).products.productId({ productId }).media.mediaId({ mediaId }).delete([body, [options]])

• tenant (type: string)
• productId (type: string)
• mediaId (type: string)

Delete media identified by media ID.

Accepted scopes:

• hybris.product_update - mandatory

client.tenant({ tenant }).products.productId({ productId }).media.mediaId({ mediaId }).delete([body, [options]]).then(...)

tenant({ tenant }).products.productId({ productId }).media.mediaId({ mediaId }).commit.post([body, [options]])

• tenant (type: string)
• productId (type: string)
• mediaId (type: string)

Confirms that the media file specified by the media id is updated and ready to be used with product.

Accepted scope:

• hybris.product_update - required to attach media to product

client.tenant({ tenant }).products.productId({ productId }).media.mediaId({ mediaId }).commit.post([body, [options]]).then(...)

License

Apache 2.0