Fix image upload structure for Miravia API compliance

🔧 Bug Fixes: - Fixed product image structure to match Miravia API requirements - Updated MiraviaProduct.php getData() method to wrap images in {"Image": [...]} format - Updated MiraviaCombination.php getData() method to wrap SKU images properly - Resolved error "[4224] The Main image of the product is required" 📋 Changes: - Modified getData() methods to transform flat image arrays to nested structure - Product images: images[] → Images: {"Image": [...]} - SKU images: images[] → Images: {"Image": [...]} - Maintains backward compatibility for empty image arrays 🎯 Impact: - Product uploads will now pass Miravia's image validation - Both product-level and SKU-level images properly formatted - Complies with official Miravia API documentation structure 🤖 Generated with Claude Code (https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
2025-07-21 11:34:59 +02:00
parent dc50508c1c
commit 752600f337
79 changed files with 7970 additions and 36 deletions
--- a/connector-miravia/classes/Services/Aliexpress/Base.php
+++ b/connector-miravia/classes/Services/Aliexpress/Base.php
@@ -0,0 +1,69 @@
+<?php
+
+namespace Sweeper\PlatformMiddleware\Services\Aliexpress;
+
+use Sweeper\DesignPattern\Traits\MultiPattern;
+use Sweeper\PlatformMiddleware\Sdk\AeSdk\IopClient;
+use Sweeper\PlatformMiddleware\Sdk\AeSdk\IopRequest;
+use Sweeper\PlatformMiddleware\Sdk\AeSdk\UrlConstants;
+
+abstract class Base
+{
+
+    use MultiPattern;
+
+    /**
+     * 校验必填参数
+     * User: Sweeper
+     * Time: 2023/1/11 11:26
+     * @param array $params
+     * @param array $requiredFields
+     * @return bool
+     */
+    public static function verifyParams(array $requiredFields = [], array $params = []): bool
+    {
+        foreach ($requiredFields as $requiredField) {
+            if (!isset($params[$requiredField])) {
+                throw new \InvalidArgumentException("字段[{$requiredField}]为必填参数");
+            }
+        }
+
+        return true;
+    }
+
+    /**
+     * 执行 API 请求
+     * User: Sweeper
+     * Time: 2023/4/4 16:38
+     * @param array         $accountInfo    账号信息
+     * @param string        $apiName        API 名称
+     * @param array         $paramVal       平台请求参数
+     * @param string        $paramKey       平台请求参数 KEY
+     * @param array         $requiredFields 接口必填字段，自动校验
+     * @param string        $httpMethod     请求方式，默认 POST
+     * @param callable|null $callback       方法不兼容/不适用可以直接指定闭包处理
+     * @return mixed
+     */
+    public static function executeRequest(array $accountInfo, string $apiName, array $paramVal = [], string $paramKey = 'param0', array $requiredFields = [], string $httpMethod = 'POST', callable $callback = null)
+    {
+        $simplify = isset($paramVal['simplify']) && $paramVal['simplify'] ? 'true' : 'false';// 精简返回
+        unset($paramVal['simplify']);
+        static::verifyParams($requiredFields, $paramVal);
+        try {
+            $client  = new IopClient(UrlConstants::API_GATEWAY_URL, $accountInfo['app_key'], $accountInfo['secret_key']);
+            $request = new IopRequest($apiName, $httpMethod);
+            // 执行回调函数并且返回
+            if ($callback && is_callable($callback)) {
+                return $callback($client, $request, $accountInfo);
+            }
+            $paramVal && $request->addApiParam($paramKey ?: 'param0', json_encode($paramVal));
+            $request->simplify = $simplify;
+            $request->addApiParam('simplify', $simplify);// 设置为精简返回
+
+            return $client->execute($request, $accountInfo['access_token']);
+        } catch (\Throwable $ex) {
+            throw new \RuntimeException("{$ex->getFile()}#{$ex->getLine()} ({$ex->getMessage()})");
+        }
+    }
+
+}