Endpoint سفارشی پیشرفته:

// ایجاد REST API سفارشی
add_action('rest_api_init', function() {
    // Register Custom Endpoint
    register_rest_route('apm/v1', '/products/(?P<id>d+)', [
        [
            'methods' => WP_REST_Server::READABLE,
            'callback' => function($request) {
                $product_id = $request->get_param('id');
                $product = get_post($product_id);
                
                if (!$product || $product->post_type !== 'product') {
                    return new WP_Error(
                        'product_not_found',
                        __('Product not found', 'advanced-product-manager'),
                        ['status' => 404]
                    );
                }
                
                // ساخت response پیشرفته
                $response = [
                    'id' => $product->ID,
                    'title' => $product->post_title,
                    'content' => apply_filters('the_content', $product->post_content),
                    'excerpt' => $product->post_excerpt,
                    'slug' => $product->post_name,
                    'date' => $product->post_date,
                    'modified' => $product->post_modified,
                    'status' => $product->post_status,
                    'meta' => [
                        'price' => get_post_meta($product->ID, '_product_price', true),
                        'sku' => get_post_meta($product->ID, '_product_sku', true),
                        'stock' => get_post_meta($product->ID, '_product_stock', true),
                    ],
                    'featured_image' => get_the_post_thumbnail_url($product->ID, 'full'),
                    'categories' => wp_get_post_terms($product->ID, 'product_category', ['fields' => 'names']),
                    'tags' => wp_get_post_terms($product->ID, 'product_tag', ['fields' => 'names']),
                    '_links' => [
                        'self' => [
                            'href' => rest_url('apm/v1/products/' . $product->ID)
                        ],
                        'collection' => [
                            'href' => rest_url('apm/v1/products')
                        ]
                    ]
                ];
                
                return rest_ensure_response($response);
            },
            'permission_callback' => function() {
                return current_user_can('read');
            },
            'args' => [
                'id' => [
                    'validate_callback' => function($param) {
                        return is_numeric($param);
                    },
                    'required' => true,
                    'description' => __('Product ID', 'advanced-product-manager'),
                ]
            ]
        ],
        [
            'methods' => WP_REST_Server::EDITABLE,
            'callback' => function($request) {
                // Update product logic
                $product_id = $request->get_param('id');
                $data = $request->get_json_params();
                
                // اعتبارسنجی داده‌ها
                if (!current_user_can('edit_post', $product_id)) {
                    return new WP_Error(
                        'forbidden',
                        __('You are not allowed to edit this product', 'advanced-product-manager'),
                        ['status' => 403]
                    );
                }
                
                // به‌روزرسانی محصول
                $updated = wp_update_post([
                    'ID' => $product_id,
                    'post_title' => sanitize_text_field($data['title'] ?? ''),
                    'post_content' => wp_kses_post($data['content'] ?? ''),
                ]);
                
                if (is_wp_error($updated)) {
                    return $updated;
                }
                
                // به‌روزرسانی meta fields
                if (isset($data['meta'])) {
                    foreach ($data['meta'] as $key => $value) {
                        update_post_meta($product_id, '_' . $key, sanitize_text_field($value));
                    }
                }
                
                return rest_ensure_response([
                    'success' => true,
                    'message' => __('Product updated successfully', 'advanced-product-manager'),
                    'data' => [
                        'id' => $product_id,
                        'updated' => current_time('mysql'),
                    ]
                ]);
            },
            'permission_callback' => function() {
                return current_user_can('edit_posts');
            }
        ]
    ]);
    
    // Endpoint برای فیلتر و جستجو
    register_rest_route('apm/v1', '/products', [
        'methods' => WP_REST_Server::READABLE,
        'callback' => function($request) {
            $params = $request->get_params();
            
            // پارامترهای جستجو
            $args = [
                'post_type' => 'product',
                'post_status' => 'publish',
                'posts_per_page' => $params['per_page'] ?? 10,
                'paged' => $params['page'] ?? 1,
            ];
            
            // فیلتر بر اساس دسته‌بندی
            if (!empty($params['category'])) {
                $args['tax_query'] = [
                    [
                        'taxonomy' => 'product_category',
                        'field' => 'slug',
                        'terms' => sanitize_text_field($params['category']),
                    ]
                ];
            }
            
            // فیلتر بر اساس برچسب
            if (!empty($params['tag'])) {
                $args['tag'] = sanitize_text_field($params['tag']);
            }
            
            // جستجوی متن
            if (!empty($params['search'])) {
                $args['s'] = sanitize_text_field($params['search']);
            }
            
            // مرتب‌سازی
            if (!empty($params['orderby'])) {
                $args['orderby'] = sanitize_text_field($params['orderby']);
                $args['order'] = $params['order'] ?? 'DESC';
            }
            
            // فیلتر قیمت
            if (!empty($params['min_price']) || !empty($params['max_price'])) {
                $meta_query = ['relation' => 'AND'];
                
                if (!empty($params['min_price'])) {
                    $meta_query[] = [
                        'key' => '_product_price',
                        'value' => floatval($params['min_price']),
                        'compare' => '>=',
                        'type' => 'NUMERIC'
                    ];
                }
                
                if (!empty($params['max_price'])) {
                    $meta_query[] = [
                        'key' => '_product_price',
                        'value' => floatval($params['max_price']),
                        'compare' => '<=',
                        'type' => 'NUMERIC'
                    ];
                }
                
                $args['meta_query'] = $meta_query;
            }
            
            // اجرای query
            $query = new WP_Query($args);
            $products = [];
            
            if ($query->have_posts()) {
                while ($query->have_posts()) {
                    $query->the_post();
                    global $post;
                    
                    $products[] = [
                        'id' => $post->ID,
                        'title' => get_the_title(),
                        'excerpt' => get_the_excerpt(),
                        'price' => get_post_meta($post->ID, '_product_price', true),
                        'image' => get_the_post_thumbnail_url($post->ID, 'medium'),
                        'link' => get_permalink(),
                    ];
                }
                wp_reset_postdata();
            }
            
            // ساخت response با pagination
            $response = [
                'data' => $products,
                'pagination' => [
                    'total' => $query->found_posts,
                    'per_page' => $args['posts_per_page'],
                    'current_page' => $args['paged'],
                    'total_pages' => ceil($query->found_posts / $args['posts_per_page']),
                ],
                '_links' => [
                    'self' => [
                        'href' => rest_url('apm/v1/products') . '?' . http_build_query($params)
                    ]
                ]
            ];
            
            return rest_ensure_response($response);
        },
        'permission_callback' => '__return_true',
        'args' => [
            'per_page' => [
                'default' => 10,
                'validate_callback' => function($param) {
                    return is_numeric($param) && $param > 0 && $param <= 100;
                }
            ],
            'page' => [
                'default' => 1,
                'validate_callback' => function($param) {
                    return is_numeric($param) && $param > 0;
                }
            ],
            'search' => [
                'sanitize_callback' => 'sanitize_text_field'
            ],
            'category' => [
                'sanitize_callback' => 'sanitize_text_field'
            ],
            'tag' => [
                'sanitize_callback' => 'sanitize_text_field'
            ],
            'min_price' => [
                'sanitize_callback' => 'floatval'
            ],
            'max_price' => [
                'sanitize_callback' => 'floatval'
            ],
        ]
    ]);
});