Menu

Register a group of devices to Knox E-FOTA (Version 2)

After generating an OAuth 2.0 token, you can now develop your web server code to communicate with the Knox E-FOTA Server.

This section shows you the steps required to register devices to Knox E-FOTA for firmware management.

Request

To register for the Knox E-FOTA service, make a REST API call to the B2B Knox E-FOTA server, sending an HTTP POST request to this URL:

https://eu-api.samsungknox.com/b2bfota/v2/groupRegister

Body

In the body of the HTTP request, provide the following information:

  • mdmId—This identifies your company among other partners in our KPP program.
  • customerId—This identifies one of your enterprise customers that will use the Knox E-FOTA service.
  • groupID—A device group identified by the enterprise IT admin to separate groups for different firmware updates . Upper case only, for example: "TEST GROUP".
  • license—This tracks customer usage of the Knox E-FOTA service for billing purposes.
    NOTE—While trying Knox E-FOTA, the development key is sent to you by email in the following format: "EFOTA1-fff555-ggg666-hh77". During commercial deployment, this license is purchased.

You encode this info into REST API calls to the Knox E-FOTA server, and also in the Android API call used to set the allowed firmware version on a device.

For details about each of these elements, see the API reference for Knox E-FOTA v2's groupRegister.

Example

Here's a sample request for registering a group of IDs and licenses to Knox E-FOTA:

<B2bGroupRegisterVO> <mdmId>d1e2f3g4h5</mdmId> <customerId>EEEE4444-FF55-AA66-BB77-CCCCCC888888</customerId> <groupId>EMMGID12312323</groupId> <license>EFOTA1-fff555-ggg666-hh77</license> </B2bGroupRegisterVO>

Response

If the API call is successful, the Knox E-FOTA server returns HTTP/1.1 200 OK . No XML data provided.

Tutorial progress

You've completed 3/6 steps! Go to the next step.