Troubleshooting Archives

Troubleshooting

What should I do when an error "Unable to Connect to tcp://store-url" occurs?

If this error occurs:

Check whether API2Cart IP is in the server’s firewall white list and restart the requests. (How to add IP to white list)
Your server’s characteristics isn’t suitable for particular shopping cart. Optimize your server configurations to establish proper work.
Increase the server’s RAM

What should I do when an error "Can't connect to URL" occurs?

If this error occurs:

Check whether API2Cart IP is in the server’s firewall white list and restart the requests. (How to add IP to white list)
Your server’s characteristics isn’t suitable for particular shopping cart. Optimize your server configurations to establish proper work.
Increase the server’s RAM

What should I do when an error "Unable to read response, or response is empty" occurs?

If this error occurs:

Check whether API2Cart IP is in the server’s firewall white list and restart the requests. (How to add IP to white list)
Your server’s characteristics isn’t suitable for particular shopping cart. Optimize your server configurations to establish proper work.
Increase the server’s RAM

What should I do when the error "The query was: SHOW TABLES" occurs?

If this error occurs, contact your server administrator to enable Base 64 support.

What should I do when an error "Store Database Validation Failed" occurs?

If this error occurs, it means that the cart or cart version, where the store is located, is not supported by API2Cart.

Another reason of the error formation is the database structure that has been changed because of the third-party module.

Update item identificator is not specified.

Please, make sure you have passed an ID of the entity in the API request. Feel free to contact API2Cart Support Team in case if you still have any issues.

When using a method I get the error Store not Found

There are two possible reasons for that. Either you have entered the incorrect store_key or the store doesn’t exist. The list of available stores can be found on the following page or using the account.cart.list API method.

API Method is not specified. What does it mean?

Please, specify the API method you would like to proceed working with. You can find the list of supported API methods here.

Duplicate record in database

We can’t create an entity with identified parameters, because of the SQL UNIQUE constraint - a row with a field which is meant to be unique already exists.

I received an error: ‘Entity already exists’. What does it mean?

This kind of error comes when API2Cart can’t create the entity due to shopping cart restriction. For example, if you’re trying to create a user with e-mail that is already registered.

‘Required parameter is not specified’. What does it mean?

Probably, you didn’t enter one of required parameters. To see the list of all the required and optional parameters, visit our Documentation section.

I get the message “Incorrect API Key” when using a method.

Check if you enter the correct API Key. It can be found on the store management page:

How can I fix an error ‘Store URL is not reachable’?

Probably your firewall blocks our IP or the site is down. If you can access the site from your browser it means that your website is working. In this case, please, contact your hosting provider and ask him to add the API2Cart IP to the white list. If it still doesn’t help, contact our Support Team.

Store already exists. What does it mean?

API2Cart already has a store with the same URL. If you don’t see it in your profile, please contact us.

I got ‘Wrong FTP Store Path’ error. How can I fix it?

Double-check the root folder where your store is located. If the shop is placed in the subdomain of your site please indicate the subdomain folder. In case you can't solve this issue feel free to contact API2Cart Support Team.

Try send requests to store from other user.

The store belongs to another account. Please make sure there are no typing errors in the store_key parameter. If you have multiple API2Cart accounts, probably you’re using an api_key from a wrong one.

Store disconnect error

API2Cart can’t disconnect the store while you perform API request to it. If you see this error for a long time, most likely you are using a program, that makes periodical requests to the store through API2Cart. Please disable it before disconnecting. If you don’t know which specific program performs requests or how to disable it feel free to contact our Support Team.

I got an error: ‘Incorrect Store Key’. What shall I do?

In this case there are several simple steps that you can follow:

Re-upload a Connection Bridge file to store’s root folder using an FTP client. Click here for more info.
Change Store Key manually: in bridge2cart folder open config.php file with any kind of text editor (i.e. Notepad). In the bottom of the file you will be able to change your Store Key that you can find at https://www.api2cart.com/app/stores.
If none of the methods above are working don’t hesitate to contact us.

How do I report a bug or request a new feature?

You can report a bug or request a new feature by contacting us. You are also welcome to contact our Customer Success manager at manager@api2cart.com in case of any issues.

Update parameters are not specified. What shall I do?

In order to update an entity please specify the attribute you want to change, for example &price=14.99. You can find the list of supported attributes in our Documentation section.

Bridge not found: ‘Incorrect FTP write permissions’ - what to do when I have this error?

API2Cart uses Bridge file that enables API interaction for some shopping carts. This folder should be uploaded to store directory via FTP client. In some cases a user may not have enough rights to change the corresponding folder. In order to fix it you have to change folder permissions:

644 or 666 for "bridge.php", depending on your server configuration;
755 or 777 for "/bridge2cart" folder, depending on your server configuration.

HTTP Error Code 406, Not Acceptable

Web browsers request for information from the server, and when it is performed, it sends an Accept header. In case if the server is not able to send that data in the requested format in the Accept header, then the server sends the 406 Not Acceptable error.

Reasons

The 406 error can appear accordingly to your mod_security rule on the server. Mod_security is a security module of Apache web server, usually permitted automatically on all hosting profiles. In case if a site, page or even function violates one of the rules, server can send the 406 error.

How to Prevent

You can turn mod_security off. Also, there is a possibility to disable a specific rule or each domain individually. Thus, if you wish to disable mod_security, go to mod_security using modsec manager plugin in control panel.

Note: There may not be the option of turning mod_security on/off in your cPanel or dedicated servers. In such cases, use command line using SSH or contact tech support to enable/disable this option.