partner10.bindKey

Purpose

Binds a Key to a specified IP address.

Signature

Method name: partner10.bindKey

Parameters

#	Type	Description
1	struct AuthInfo	requesting party authentication information
2	string	number of a key that you want to bind to an IP address
3	string	IP address to bind

Returns

Field	Type	Description
resultCode	int	code for command execution result (see below)
resultDesc	string	textual description of command execution result (see below)
keyNumber	string	key number. The key pattern is XXXX.XXXXXXXX.XXXX

Result Codes

resultCode	resultDesc
100	Key <key number> was successfully bound to given IP address.
101	Key <key number> was successfully bound to given IP address. Key <key number> was unbound.
200	Client authorization failed
201	Access to this method is denied
202	Access to this object is denied
220	Key <key number> is not found
221	License key <key number> is marked as problem
222	License key <key number> is terminated
253	This customer account is unconfirmed. No further actions for this customer are allowed.
272	Another license bound to given IP address.
300	Internal error, please try after some time
400	Incorrect authorization info format
405	Incorrect IP address format
410	Incorrect key number format: "<key number>"
452	Incorrect object type for this operation

XML Examples

Request message

<methodCall>

  <methodName>partner10.bindKey</methodName>

  <params>

    <param>

      <value>

        <struct>

          <member>

            <name>login</name>

            <value>

              <string>API_LOGIN</string>

            </value>

          </member>

          <member>

            <name>password</name>

            <value>

              <string>API_PASSWORD</string>

            </value>

          </member>

        </struct>

      </value>

    </param>

    <param>

      <value>

        <string>PLSK.00123456.0000</string>

      </value>

    </param>

    <param>

      <value>

        <string>192.168.0.1</string>

      </value>

    </param>

  </params>

</methodCall>

Response message

<?xml version="1.0"?>

<methodResponse>

  <params>

    <param>

      <value>

        <struct>

          <member>

            <name>resultCode</name>

            <value>

              <int>100</int>

            </value>

          </member>

          <member>

            <name>resultDesc</name>

            <value>Key PLSK.00123456.0000 was successfully bound to given IP address.</value>

          </member>

          <member>

            <name>keyNumber</name>

            <value>PLSK.00123456.0000</value>

          </member>

        </struct>

      </value>

    </param>

  </params>

</methodResponse>