baseUrl URL WooCommerce | string | si | — https://mio-shop.it | URL base WordPress dove gira WooCommerce. REST API: {baseUrl}/wp-json/wc/v3/*. HTTPS obbligatorio per Basic Auth (raccomandato). |
consumerKey Consumer Key | string (encrypted) | si | — ck_... | Genera da WooCommerce → Settings → Advanced → REST API → Add key. Scope: Read/Write per CRUD completo, Read per query-only. |
consumerSecret Consumer Secret | string (encrypted) | si | — cs_... | Compagno della consumer_key. Conserva al momento della generazione (NON re-visualizzabile dopo). |
action Azione | enumlistgetcreateupdatedeletebatch
| si | list | list = GET many. get = GET one by ID. create = POST. update = PUT. delete = DELETE (?force=true per hard delete). batch = POST .../batch (fino a 100 ops in 1 round-trip). |
resource Resource | enumproductsproducts/variationsproducts/categoriesproducts/attributesproducts/tagsordersorders/notesorders/refundscustomerscouponsreportstaxesshipping/zonespayment_gatewayswebhookssettings
| si | products | Endpoint WC. Per nested (es. variazioni prodotto): "products/variations" con parentId nel customPath. |
parentId Parent ID | expression | no | — 42 | Per nested resources (variations under product, notes/refunds under order). Es: resource="products/variations", parentId=42 → /products/42/variations. |
id ID | expression | no | — | ID risorsa (intero). Obbligatorio per get/update/delete. |
perPage Per page | number | no | 10 | Default 10, max 100 (WC cap). |
page Page | number | no | 1 | Pagination 1-indexed. X-WP-TotalPages header per loop completo. |
search Search | expression | no | — nome prodotto | Full-text WC server-side. |
status Status filter | expression | no | — pending,processing,completed | Per orders: pending/processing/on-hold/completed/cancelled/refunded/failed/trash. Per products: draft/pending/private/publish. CSV multi-status. |
after Data dopo (ISO 8601) | expression | no | — 2026-01-01T00:00:00 | Filtra date_created >= valore. Ottimo per sync incrementale. |
before Data prima (ISO 8601) | expression | no | — 2026-12-31T23:59:59 | Filtra date_created <= valore. |
customer Customer ID filter | expression | no | — | Solo per orders. Filtra ordini di un cliente specifico. |
orderby Order by | enumdateidincludetitleslugpricepopularityrating
| no | date | Solo per list. price/popularity/rating solo su products. |
orderDir Order direction | enumascdesc
| no | desc | — |
data Body JSON | expression | no | — {"name":"Maglietta XL","type":"simple","regular_price":"29.90","stock_quantity":10,"manage_stock":true} | Per create/update. Schema completo: https://woocommerce.github.io/woocommerce-rest-api-docs/. Per products: name, type, regular_price, sale_price, stock_quantity, manage_stock, categories[], images[], attributes[], variations[]. |
batchData Batch JSON | expression | no | — {"create":[{...},{...}],"update":[{"id":42,...}],"delete":[1,2,3]} | Per action=batch. Object con chiavi create/update/delete. Max 100 ops totali per request (WC default). create[] = array di body POST. update[] = array di body PUT con id incluso. delete[] = array di IDs. |
force Force delete (hard) | enumfalsetrue
| no | false | true = bypass trash (irreversibile). Default WC: orders e products vanno in trash. |