Basic Requirements
Please make sure your store meets these basic requirements as these will fix most errors:
1. WooCommerce version 4.0 installed. Previous versions won't work.
2. Pretty/Custom Permalinks are enabled
Pretty/Custom Permalinks are enabled in your WordPress Dashboard under Settings > Permalinks
3. REST API is enabled
To enable the REST API within WooCommerce, visit the tab and tick the Enable REST API checkbox WooCommerce > Settings > API
https://Yourwoocommercesite.com/wp-json/wc/v3
4. Plugin conflicts
Make review the following plugins are disabled and ideally uninstalled they are known to cause errors with the REST API. Please discuss with your developer
- JetPack by WordPress.com
- W3 Cache - Or managed to not try to cache the API calls
- Bulk Add Terms
- Akismet antispam
- Currency Switcher
- Smush Image Compression and Optimization
- WPML (The WordPress Multilingual Plugin)
- Wordapp
- TeraWallet
- Acowebs Woocommerce Dynamic Pricing (Prevents updating product's price to WooCommerce)
Common Errors
1. Invalid Signature - provided signature does not match
This error occurs when your Site Address, WordPress Address, and the Connected Store address don't match.
Head over to your WordPress dashboard, select the Settings tab, and you will see the WordPress Address and Site Address.
You will not get the 'Invalid Signature - provided signature does not match' error from your server when all the three addresses/URLs are the same.
2. Product Request Error
This error means that ShopMaster had not received your server's response or your server has some internal errors, you need to check your server's log to locate the problem and resolve it accordingly.
Please note that when publishing a product to WooCommerce, the amount of the images over 11 will probably cause the internal server error.
3. Product Request Error: Status message: Not Found. Reference message: Not Found The requested URL /wp-json/wc/v2/products was not found on this server.
This error is usually caused by an incorrect Permalinks setting, please make sure the option 'Default' is NOT being selected.
4. Product Request Error: You are not allowed to create resources
This error means the request is blocked by your server, which is usually caused by some Wordpress security plugins or configuration of server settings. Please disable all of the plugins except for WooCommerce and try again. If you're still having problems creating products to WooCommerce, this article has some good suggestions for resolving common WooCommerce server configuration issues.
8. Product Request Error: Status message: OK. Reference message: Fatal error: Out of memory
Please try to increase the WordPress PHP memory limit:
https://wordpress.org/support/article/editing-wp-config-php/#increasing-memory-allocated-to-php
9. Fatal error: Maximum execution time of 30 seconds exceeded
Please refer to this article:
https://www.wpbeginner.com/wp-tutorials/how-to-fix-fatal-error-maximum-execution-time-exceeded-in-wordpress/
10. Product Request Error: woocommerce_product_image_upload_error:Error getting remote image [URL]. Error: cURL error 28: Operation timed out after 10001 milliseconds with [number] out of [number] bytes received.
Increase your server's 'max_input_time' from -1 to 36000 should fix this issue.
11. Product Request Error: Moved Permanently
a. If you have changed the site URL from 'HTTP' to 'https', we need to reconnect your store with the new site URL.
12. Product Request Error: You don't have permission to access...
This error code shows when your server permissions don't allow access to a specific page. Please refer to this article:
How to Fix the 403 Forbidden Error in WordPress
13. Product Request Error: Internal Server Error
Please refer to these articles:
https://www.wpbeginner.com/wp-tutorials/how-to-fix-the-internal-server-error-in-wordpress/comment-page-5/
https://theme.co/apex/forum/t/woocommerce-creating-internal-server-error/35785
15. Product Request Error: woocommerce_rest_cannot_view: Sorry, you cannot view this resource.
We need to reconnect your store .
16. Product Request Error: woocommerce_rest_cannot_create: Sorry, you are not allowed to create resources.
This error is caused by plugins like the WordPress plugin 'TeraWallet' by WCBeginner, disabling the plugin should fix this issue.
17. Read timed out or Publish time out Error
This's a common issue of WooCommerce, our tech team has checked it several times. They found this issue is usually caused by the server response slowly, or uploading the supplier's images to your server time out.
Other customers have shared some experience to resolve this issue, such as restarting the server, disabling all other plugins except for WooCommerce, or removing some images before publishing. You can have a try in the same way.
18. Error 400 - You are not allowed to list resources
https://woocommerce-playground.herokuapp.com/
Create a new WooCommerce REST API key under Settings > Advanced
This will give you a
Consumer Key:
Consumer Secret:
If you can access with "insecure mode" check mod Rewrite rules,
Needed for WooCommerce API
RewriteRule ^index.php$ - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization},L]
We also have an insecure headers mode available
For the "new" REST API
- For secure connections (HTTPS), you need to use "Basic Authentication".
- For non-secure connections (HTTP), you need to use "oAuth1 Authentication".
If you use the wrong authentication with the wrong connection, you'll get the 401 response message.
This is covered in the WooCommerce API documentation: https://woocommerce.github.io/woocommerce-rest-api-docs/#authentication-over-https
Also note that normally you would pass the CK and CS in as header fields, but depending on how the server is configured, you may find that it will not parse the header fields correctly, so you may get success if you include the CK and CS in the URL as parameters:
https://website.tld/wp-json/wc/v1/products?consumer_key=[key]&consumer_secret=[secret]