Magento as default provide API, but if you want to manage different data or you want to add a custom field, then Magento API will not be able to attain your requirement. That generates the demand to develop custom API through which you will able to manage your data and fields.

In this article, I will explain you the process of creating API(Application Program Interface) in Magento 2.

Add module.xml file in app/code/Magemonkeys/CustomApi/etc and copy the following code in it:

<?xml version="1.0"?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:Module/etc/module.xsd">
    <module name="Magemonkeys_CustomApi" setup_version="1.0.0" />
</config>

<?xml version="1.0"?>

</config>

Add registration.php in app/code/Magemonkeys/CustomApi and copy the following code in it:

<?php
\Magento\Framework\Component\ComponentRegistrar::register(
    \Magento\Framework\Component\ComponentRegistrar::MODULE,
    'Magemonkeys_CustomApi',
    __DIR__
);

<?php

\Magento\Framework\Component\ComponentRegistrar::register(

\Magento\Framework\Component\ComponentRegistrar::MODULE,

'Magemonkeys_CustomApi',

__DIR__

);

Add webapi.xml file in app/code/Magemonkeys/CustomApi/etc and copy the following code in it:

<?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/hello/name/:name" method="GET">
        <service class="Magemonkeys\CustomApi\Api\HelloInterface" method="name"/>
        <resources>
            <resource ref="anonymous"/>
        </resources>
    </route>
</routes>

<?xml version="1.0"?>

</resources>

</route>

</routes>

Add di.xml file in app/code/Magemonkeys/CustomApi/etc and copy the following code in it:

<?xml version="1.0"?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:ObjectManager/etc/config.xsd">
    <preference for="Magemonkeys\CustomApi\Api\HelloInterface"
                type="Magemonkeys\CustomApi\Model\Hello" />
</config>

<?xml version="1.0"?>

<preference for="Magemonkeys\CustomApi\Api\HelloInterface"

type="Magemonkeys\CustomApi\Model\Hello" />

</config>

Add HelloInterface.php file in app/code/Magemonkeys/CustomApi/Api and copy the following code in it:

<?php
namespace Magemonkeys\CustomApi\Api;
 
interface HelloInterface
{
    /**
     * Returns greeting message to user
     *
     * @api
     * @param string $name Users name.
     * @return string Greeting message with users name.
     */
    public function name($name);
}

<?php

namespace Magemonkeys\CustomApi\Api;

interface HelloInterface

{

/**

* Returns greeting message to user

* @api

* @param string $name Users name.

* @return string Greeting message with users name.

public function name($name);

}

Add Hello.php file in app/code/Magemonkeys/CustomApi/Model and copy the following code in it:

<?php
namespace Magemonkeys\CustomApi\Model;
use Magemonkeys\CustomApi\Api\HelloInterface;
 
class Hello implements HelloInterface
{
    /**
     * Returns greeting message to user
     *
     * @api
     * @param string $name Users name.
     * @return string Greeting message with users name.
     */
    public function name($name) {
        return "Hello, " . $name;
    }
}

<?php

namespace Magemonkeys\CustomApi\Model;

use Magemonkeys\CustomApi\Api\HelloInterface;

class Hello implements HelloInterface

{

/**

* Returns greeting message to user

* @api

* @param string $name Users name.

* @return string Greeting message with users name.

public function name($name) {

return "Hello, " . $name;

}

To test REST you can go to http://{domain_name}/rest/V1/{method}/{attribute}/{value}.

Example: http://magento2.loc/rest/V1/hello/name/Jayesh.

This is how the response should look like for this example:

<response>Hello, Jayesh</response>

1	<response>Hello, Jayesh</response>

Hope this guide helped you understand the procedure of creating custom API in Magento 2. If you have any queries regarding the blog, please comment below.

Was this article helpful?

YesNo

Fill the below form if you have any Magento programming need.