nshop/packages/Longyi/FreeGift/src/ApiResource/AddGiftInput.php

<?php

namespace Longyi\FreeGift\ApiResource;

use ApiPlatform\Metadata\ApiProperty;
use Symfony\Component\Serializer\Annotation\Groups;

/**
 * createAddGift 的入参。
 *
 * ⚠ 属性一律 snake_case：GraphQL 传入的 camelCase 字段名会被转换后再
 * 反序列化到属性上，写成 camelCase 会收到 null（同输出侧）。GraphQL 侧
 * 的字段名仍是 camelCase（sku / ruleId / qty）。
 */
class AddGiftInput
{
    #[Groups(['mutation'])]
    #[ApiProperty(description: '赠品 SKU', required: true)]
    public ?string $sku = null;

    #[Groups(['mutation'])]
    #[ApiProperty(description: '赠品规则（cart_rules.id）', required: true)]
    public ?int $rule_id = null;

    #[Groups(['mutation'])]
    #[ApiProperty(description: '数量，默认 1，超出剩余名额自动截断')]
    public ?float $qty = null;
}