As every developer working with Magento knows, it’s a robust beast! It is highly customizable and has many features, but it also requires a powerful server and certain host configurations.

In our experience, depending on the server type and/or OS, there can be issues that will arise. Because of that, below, we’ve outlined some pre-requisite checks for developers to go through, before trying to connect Magento with ShipHero.

Verify oAuth

Before trying to authenticate the magento store with your ShipHero account, please verify that you have oauth installed and enabled for PHP. There are many articles online to help your developer get it installed and enabled for your respective server.

Verify API Endpoint Access

ShipHero uses the REST endpoints in Magento 1.x, however, they are not enabled by default. You can check your magento site by visiting the following url from your base domain.

http://www.mymagentostore.com/api/rest/products

You should see the following XML:

<magento_api>
  <messages>
    <error>
      <data_item>
        <code>403</code>
        <message>Access denied</message>
      </data_item>
    </error>
  </messages>
</magento_api>

If you get a 404 Missing Page, then your developer will need to allow access to the API rest endpoints.

For Apache server, uncomment the following line in your .htaccess file:

############################################
## rewrite API2 calls to api.php (by now it is REST only)
RewriteRule ^api/rest api.php?type=rest [QSA,L]

For NGinx server, add the following to your host configuration:

location /api {
  rewrite ^/api/rest /api.php?type=rest last;
}

Once you’ve made those changes, restart the app server and test your api endpoint once more.

Test Your API Endpoints

Have your developers follow the Magento 1.x REST guide, to test the Product API. ShipHero requires an admin API rest role, so follow the instructions in the guide, for the Admin Role, titled 'Retrieve the list of products for Admin user with OAuth authentication'.

http://devdocs.magento.com/guides/m1x/api/rest/authentication/oauth_authentication.html

This will produce a log that we will look at to understand the errors so that we can work more quickly to resolve your issues. Please send us that log at support@shiphero.com

Once you’ve verified that your server can properly handle Rest API requests, via GET, POST, and PUT, and you can get product info successfully, then you can move on to authenticating Magento with ShipHero. 

Learn More: Connecting Magento 1.


Not started using ShipHero yet? You can go ahead and get started now

If you just want to learn more about how ShipHero may be able to help solve your challenges, you can schedule a free call with our solutions team.

Did this answer your question?