ebay-api 8.4.0 → 8.4.1

package/README.md

@@ -9,7 +9,7 @@
 [![npm](https://img.shields.io/npm/dt/ebay-api.svg?style=flat-square)](https://www.npmjs.com/package/ebay-api)
 
 This eBay API implements both Traditional \(xml\) and the RESTful eBay API.
-It supports `client credentials grant` and `authorization code grant` \(Auth'N'Auth, OAuth2 and IAF\).
+It supports `client credentials grant` and `authorization code grant` \(Auth'N'Auth, OAuth2 and IAF\). Digital Signature is supported too.
 
 * [API Browser Examples](https://hendt.github.io/ebay-api/)
 * [API Documentation](https://hendt.gitbook.io/ebay-api/)
@@ -21,7 +21,7 @@ It supports `client credentials grant` and `authorization code grant` \(Auth'N'A
 
 ## Changelog
 
-* `v8.4.0` is the latest release.
+* `v8.4.1` is the latest release.
 * See [here](https://github.com/hendt/ebay-api/blob/master/CHANGELOG.md) for the full changelog.
 
 ## Implementation status
@@ -88,9 +88,9 @@ const eBay = new eBayApi({
 
   siteId: eBayApi.SiteId.EBAY_US, // required for traditional APIs, see https://developer.ebay.com/DevZone/merchandising/docs/Concepts/SiteIDToGlobalID.html
 
-  marketplaceId: eBayApi.MarketplaceId.EBAY_US, // defautl. required for RESTful APIs
-  acceptLanguage: eBayApi.Locale.en_US, // defautl
-  contentLanguage: eBayApi.ContentLanguage.en_US, // defautl.
+  marketplaceId: eBayApi.MarketplaceId.EBAY_US, // default. required for RESTful APIs
+  acceptLanguage: eBayApi.Locale.en_US, // default
+  contentLanguage: eBayApi.ContentLanguage.en_US, // default.
 
   // optional parameters, should be omitted if not used
   devId: '-- devId --', // required for traditional Trading API
@@ -254,6 +254,8 @@ This is how it would look like if you use `express`:
 ```javascript
 import eBayApi from 'ebay-api';
 
+
+// This is your RUName endpoint like https://your-ebay.app/success
 app.get('/success', async function (req, res) {
   // 3. Get the parameter code that is placed as query parameter in redirected page
   const code = req.query.code; // this is provided from eBay
@@ -309,16 +311,16 @@ app.get('/orders/:id', async function (req, res) {
 ## Digital Signature
 Signatures are required when the call is made for EU- or UK-domiciled sellers, and only for the following APIs/methods:
 
-* All methods in the Finances API
-* issueRefund in the Fulfillment API
-* GetAccount in the Trading API
+* All methods in the Finances API -> (`eBay.finances.XXX.sign.YYY()`)
+* issueRefund in the Fulfillment API -> (`eBay.sell.fulfillment.sign.issueRefund()`)
+* GetAccount in the Trading API -> (`eBay.trading.GetAccount(null, { sign: true }))`)
 * The following methods in the Post-Order API:
-  - Issue Inquiry Refund
-  - Issue case refund
-  - Issue return refund
-  - Process Return Request
-  - Create Cancellation Request
-  - Approve Cancellation Request
+  - Issue Inquiry Refund -> (`eBay.postOrder.inquiry.sign.issueInquiryRefund()`)
+  - Issue case refund -> (`eBay.postOrder.inquiry.sign.issueCaseRefund()`)
+  - Issue return refund -> (`eBay.postOrder.inquiry.sign.issueReturnRefund()`)
+  - Process Return Request -> (`eBay.postOrder.inquiry.sign.processReturnRequest()`)
+  - Create Cancellation Request -> (`eBay.postOrder.inquiry.sign.createCancellation()`)
+  - Approve Cancellation Request -> (`eBay.postOrder.inquiry.sign.approveCancellationRequest()`)
 
 ### How to use Digital Signature
 ```js
@@ -375,7 +377,7 @@ In any case eBay adds a new subdomain, it's also possible to configure whatever
   eBay.buy.browse.api({subdomain: 'apiy'}).getItem() // now it will use https://apiy.ebay.com
 ```
 
-### Change RESTful API call config
+### Return raw RESTful API response
 
 ```javascript
   eBay.buy.browse.api({
@@ -403,8 +405,8 @@ eBay.OAuth2.on('refreshClientToken', (token) => {
 });
 ```
 
-To manuel refresh the auth token use `eBay.OAuth2.refreshAuthToken()` and for the client
-token `eBay.OAuth2.refreshClientToken()`.
+To manual refresh the auth token use `eBay.OAuth2.refreshAuthToken()` and for the client
+token use `eBay.OAuth2.refreshClientToken()`.
 Keep in mind that you need the 'refresh_token' value set.
 
 ```javascript

package/dist/api/restful/index.js

@@ -149,6 +149,9 @@ export default class Restful extends Api {
         if (error.name === EBayInvalidAccessToken.name) {
             return true;
         }
+        else if (error?.meta?.res?.status === 403 && this.apiConfig.basePath === '/sell/inventory/v1') {
+            return true;
+        }
         return error?.meta?.res?.status === 401 && this.apiConfig.basePath === '/post-order/v2';
     }
     async request(apiRequest, apiConfig = this.apiConfig, refreshToken = false) {