入力パラメーター付きのmagento 2 apiルート

入力パラメーターを使用してAPIルートを作成しようとしていますが、期待した結果が得られません。

これが私のwebapi.xmlです：

<?xml version="1.0"?>
<routes xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../../../../../app/code/Magento/Webapi/etc/webapi.xsd">
    <route url="/V1/foo" method="POST" secure="true">
        <service class="..\FooInterface"
                 method="getFooById"/>
        <resources>
            <resource ref="anonymous"/>
        </resources>
        <data>
            <parameter name="id" force="true">%id%</parameter>
        </data>
    </route>
</routes>

ここに私のインターフェース：

interface FooInterface
{
    /**
     * Test function
     *
     * @api
     * @param string $id
     * @return string
     */
    public function getFooById($id);
}

そしてここにクラス：

class Foo implements FooInterface
{
    /**
     * {@inheritdoc}
     */
    public function getFooById($id){
        return $id;
    }
}

設定でdi.xmlを省略しています。さて、そのルートを呼び出すと、何をしても、返されるのはすべてです%id%。パラメータを何も指定しなくても、エラーや何かの代わりにそれを取得します。

ここで何が悪いのですか？

郵便配達の呼び出しは次のとおりです。

私は試した：

• getリクエストを送信する
• パラメータ付きのgetリクエストを送信する /order?id=foo
• 投稿リクエストを送信する
• フォームデータを含む投稿リクエストを送信する
• 生データを含む投稿リクエストを送信する（スクリーンショットに表示）

すべて同じ結果になります-> %id%

コミュニティエディションを使用しています。

コアモジュールを確認した後parameter、webapi.xmlのノードはselfリソースタイプのカスタマーモジュールでのみ使用されていることがわかりました。

以下のファイルは、値を持つパラメータープレースホルダーを変換します。

/**
 * Replaces a "%customer_id%" value with the real customer id
 */
Magento\Webapi\Controller\Rest\ParamOverriderCustomerId 

APIでパラメーターを渡す方法は2つあります。

解決策1：

webapi.xml 以下のように：

<?xml version="1.0"?>
<routes xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:module:Magento_Webapi:etc/webapi.xsd">
    <route url="/V1/foo" method="POST" secure="true">
        <service class="..\FooInterface" method="getFooById"/>
        <resources>
            <resource ref="anonymous"/>
        </resources>
    </route>
</routes>

また$id、インターフェイスクラスと実装定義でも引数を指定します。この場合、IDを本文コンテンツとして渡す必要があります。

解決策2：

webapi.xml 以下のように：

<?xml version="1.0"?>
<routes xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:module:Magento_Webapi:etc/webapi.xsd">
    <route url="/V1/foo:id" method="POST" secure="true">
        <service class="..\FooInterface" method="getFooById"/>
        <resources>
            <resource ref="anonymous"/>
        </resources>
    </route>
</routes>

また$id、インターフェイスクラスと実装定義でも引数を指定します。この場合、IDを引数としてURLに渡す必要があります。これについては、製品モジュールも確認できます。