2khat connects your WooCommerce store to the 2khat platform by exposing a secure, paginated REST API for product catalog synchronization.<\/p>\n\n
After registering your store with the 2khat team, install and activate this plugin to allow 2khat to fetch your published products and variations.<\/p>\n\n
public_key.pem is the 2khat RSA public key used to verify API request signatures. It is not a private credential and must remain in the plugin directory.<h3>Authentication<\/h3>\n<\/code><\/pre>\n\nAll 2khat API requests require RSA domain signature verification.<\/p>\n\n
Signing (2khat server side):<\/strong><\/p>\n\n\n- Normalize the store domain: use the host from
site_url()<\/code>, without a www.<\/code> prefix.<\/li>\n- Sign the domain string with the 2khat private key using SHA256.<\/li>\n
- Base64-encode the binary signature.<\/li>\n
Send it in the request header:<\/p>\n\n
Authorization: Twokcs <\/p><\/li>\n<\/ol>\n\n
Legacy clients may also use Authorization: Basic <base64-signature><\/code> during migration.<\/p>\n\nExample (OpenSSL CLI):<\/strong><\/p>\n\n`\n<\/code><\/pre>\n\necho -n \"example.com\" | openssl dgst -sha256 -sign 2khat_private.pem | openssl base64 -A\n <h3>REST API<\/h3>\n**GET**<\/code>\/wp-json\/twokcs\/v1\/version`<\/p>\n\nReturns the plugin version.<\/p>\n\n
GET<\/strong> \/wp-json\/twokcs\/v1\/products?page=1&per_page=100<\/code><\/p>\n\nReturns paginated published products with nested variations.<\/p>\n\n
GET<\/strong> \/wp-json\/twokcs\/v1\/categories?page=1&per_page=100<\/code><\/p>\n\nReturns paginated product categories.<\/p>\n\n
GET<\/strong> \/wp-json\/twokcs\/v1\/attributes?page=1&per_page=100<\/code><\/p>\n\nReturns paginated product attributes.<\/p>\n\n
GET<\/strong> \/wp-json\/twokcs\/v1\/attribute-terms?page=1&per_page=100<\/code><\/p>\n\nReturns paginated attribute terms across all attributes. Optionally filter by attribute:<\/p>\n\n
GET<\/strong> \/wp-json\/twokcs\/v1\/attribute-terms?attribute_id=1&page=1&per_page=100<\/code><\/p>\n\nGET<\/strong> \/wp-json\/twokcs\/v1\/variants?product_ids=10,20<\/code><\/p>\n\nReturns compact published variants grouped by parent product ID. Each item includes parent product fields (product_id<\/code>, type<\/code>, manage_stock<\/code>, price<\/code>, regular_price<\/code>, sale_price<\/code>, stock_quantity<\/code>, stock_status<\/code>) and a variants<\/code> array with: id<\/code>, on_sale<\/code>, status<\/code>, price<\/code>, regular_price<\/code>, sale_price<\/code>, stock_quantity<\/code>, stock_status<\/code>. Simple products return an empty variants<\/code> array and their own price\/stock on the parent object.<\/p>\n\nGET<\/strong> \/wp-json\/twokcs\/v1\/variants?ids=305,306,307<\/code><\/p>\n\nReturns compact published variants for the given variation IDs in request order. Response shape: { count, results: [...] }<\/code> with the same variant fields as above.<\/p>\n\nGET<\/strong> \/wp-json\/twokcs\/v1\/variant?id=305<\/code><\/p>\n\nReturns a single compact published variant object with the same fields as above. Returns 404 when the variation is missing or not published.<\/p>\n\n
POST<\/strong> \/wp-json\/twokcs\/v1\/orders<\/code><\/p>\n\nCreates a WooCommerce order for the 2khat platform.<\/p>\n\n
Request body (JSON):<\/p>\n\n
\nexternal_order_id<\/code> (required) \u2014 platform order id, stored as _twokcs_external_order_id<\/code><\/li>\nline_items<\/code> (required) \u2014 array of { product_id, variation_id?, quantity }<\/code><\/li>\nbilling<\/code> \/ shipping<\/code> \u2014 address objects<\/li>\nstatus<\/code> \u2014 WooCommerce status without wc-<\/code> prefix (default: processing<\/code>)<\/li>\ncustomer_note<\/code> \u2014 optional note<\/li>\nmeta_data<\/code> \u2014 optional array of { key, value }<\/code> (public keys and _twokcs_*<\/code> only)<\/li>\n<\/ul>\n\nReturns 201<\/strong> with a compact order object. Duplicate external_order_id<\/code> returns 409<\/strong> with existing_order_id<\/code>.<\/p>\n\nGET<\/strong> \/wp-json\/twokcs\/v1\/order<\/code><\/p>\n\nLists orders as { count, max_pages, results }<\/code>. All filters are optional and combinable: id<\/code>, external_order_id<\/code>, status<\/code>, plus page<\/code> \/ per_page<\/code>. Bare GET \/order<\/code> returns a paginated list. No matches return an empty results<\/code> array (200). If both id<\/code> and external_order_id<\/code> are provided and refer to different orders, the request returns 400.<\/p>\n\nExamples:<\/p>\n\n
\n\/wp-json\/twokcs\/v1\/order<\/code><\/li>\n\/wp-json\/twokcs\/v1\/order?status=processing<\/code><\/li>\n\/wp-json\/twokcs\/v1\/order?id=123<\/code><\/li>\n\/wp-json\/twokcs\/v1\/order?external_order_id=2khat-12345<\/code><\/li>\n\/wp-json\/twokcs\/v1\/order?id=123&status=processing<\/code><\/li>\n<\/ul>\n\nEach result includes: id<\/code>, status<\/code>, external_order_id<\/code>, tracking_code<\/code>, tracking_provider<\/code>, shipping_method<\/code>, date_created<\/code>, date_modified<\/code>, total<\/code>, currency<\/code>, line_items<\/code>.<\/p>\n\nQuery parameters (all catalog endpoints):<\/p>\n\n
\npage<\/code> \u2014 page number (default: 1, minimum: 1)<\/li>\nper_page<\/code> \u2014 items per page (default: 100, maximum: 200)<\/li>\nattribute_id<\/code> \u2014 (attribute-terms only) filter terms to a single attribute<\/li>\nproduct_ids<\/code> \u2014 (variants only) comma-separated parent product IDs; returns variants grouped by product<\/li>\nids<\/code> \u2014 (variants only) comma-separated variation IDs; returns a flat list in request order<\/li>\nid<\/code> \u2014 (variant \/ order) single variation or WooCommerce order ID filter<\/li>\nexternal_order_id<\/code> \u2014 (order only) filter by 2khat external order id meta<\/li>\nstatus<\/code> \u2014 (order only) optional WooCommerce status filter<\/li>\ndebug<\/code> \u2014 include SQL query stats only when WP_DEBUG<\/code> and TWOKCS_DEBUG<\/code> are enabled, or when the twokcs_allow_debug<\/code> filter returns true. Full query details require SAVEQUERIES<\/code> enabled in wp-config.php<\/code>.<\/li>\n<\/ul>\n\n\n\n- Upload the
2khat<\/code> folder to \/wp-content\/plugins\/<\/code>.<\/li>\n- Activate the plugin through the WordPress Plugins screen.<\/li>\n
- Ensure WooCommerce is installed and active.<\/li>\n
- Confirm
public_key.pem<\/code> is present in the plugin directory.<\/li>\n<\/ol>\n\n\n1.0.8<\/h4>\n\n\nGET \/order<\/code> returns a paginated list; id<\/code>, external_order_id<\/code>, and status<\/code> are optional filters<\/li>\n<\/ul>\n\n1.0.7<\/h4>\n\n\n- Add create order (
POST \/orders<\/code>) and track order (GET \/order<\/code>) endpoints<\/li>\n<\/ul>\n\n1.0.6<\/h4>\n\n\n- Align text domain with WordPress.org slug
2khat-catalog-sync<\/code><\/li>\n<\/ul>\n\n1.0.5<\/h4>\n\n\n- Rename all plugin globals from
dokhat<\/code> to twokcs<\/code> prefix for WordPress.org compliance<\/li>\n- Update REST namespace to
twokcs\/v1<\/code> and auth scheme to Twokcs<\/code><\/li>\n<\/ul>\n\n1.0.4<\/h4>\n\n\n- Align plugin folder and main file name with WordPress.org slug
2khat<\/code><\/li>\n- Fix auth header documentation to match the
Dokhat<\/code> scheme accepted by the plugin<\/li>\n<\/ul>\n\n1.0.3<\/h4>\n\n\n- Rename display name to 2khat Catalog Sync (WordPress.org trademark requirement)<\/li>\n<\/ul>\n\n
1.0.2<\/h4>\n\n\n- Rename plugin for WordPress.org compliance (2khat WooCommerce Catalog Sync)<\/li>\n
- Remove runtime SAVEQUERIES global side effects from debug mode<\/li>\n
- Document public_key.pem as intentional RSA public key<\/li>\n<\/ul>\n\n
1.0.1<\/h4>\n\n\n- Align plugin metadata for WordPress.org submission<\/li>\n<\/ul>\n\n
1.0.0<\/h4>\n\n\n- Initial 2khat release<\/li>\n
- Modular plugin architecture<\/li>\n
- RSA domain authentication with 2khat key pair<\/li>\n
- Optimized bulk product export endpoint<\/li>\n
- Compatibility with Discount Rules for WooCommerce and Woodmart theme<\/li>\n<\/ul>","raw_excerpt":"Official WooCommerce catalog sync plugin for the 2khat platform.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/pt-ao.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/327500","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pt-ao.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/pt-ao.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/pt-ao.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=327500"}],"author":[{"embeddable":true,"href":"https:\/\/pt-ao.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/mohammad61"}],"wp:attachment":[{"href":"https:\/\/pt-ao.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=327500"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/pt-ao.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=327500"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/pt-ao.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=327500"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/pt-ao.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=327500"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/pt-ao.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=327500"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/pt-ao.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=327500"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}