| | english | español | français |
  Home|Resources|BCH Interoperability Services 3.0|unregister   Printer-friendly version

unregister

Unregister an existing document from the BCH.

[Visual Basic]

Public Function unregister(refID As String, email As String, password As String) As String

[C#]

public string unregister(string refID, string email, string password);

Parameters

refID
    The ID of the document to unregister.

email
    The registered email address

password
    The password

Return Value

A confirmation token confirming the transaction. The maximum token length is 40 characters. If the method fails, a SOAP exception will be thrown.

Remarks

Email address and Password

The BCH Web Service shares its user database with the Central Portal of the BCH. Therefore, any email address and password which are valid on the Central Portal of the BCH is valid.

The password being sent in plaintext across the network, the use of SSL is critical.

In the case where a digital certificate has been associated with the user account, the BCH Web Service will require the SOAP request to be digitaly signed using that digital certificate.

Document ID

In order to unregister an existing document, you have to pass the ID you have chosen when registering the document.

* The IDs of the registered documents are chosen by the organization which register them. By choosing themselves the ID of their document, the organization do not have to keep track of the BCH IDs.

SOAP Request

The following is a sample SOAP request. The placeholders shown need to be replaced with actual values.

POST /service/3.0/service.asmx HTTP/1.1
Host: bch.biodiv.org
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://bch.biodiv.org/service/3.0/unregister"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  

   <soap:Body>
    

      <unregister xmlns="http://bch.biodiv.org/service/3.0">
      

         <refID>string</refID>
      

         <email>string</email>
      

         <password>string</password>
    

      </unregister>
  

   </soap:Body>

</soap:Envelope>

SOAP Response

The following is a sample SOAP response. The placeholders shown need to be replaced with actual values.

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  

   <soap:Body>
    

      <unregisterResponse xmlns="http://bch.biodiv.org/service/3.0">
      

         <unregisterResult>string</unregisterResult>
    

      </unregisterResponse>
  

   </soap:Body>

</soap:Envelope>

   
   
Update on 2008-01-18
United Nations Environment Programme United Nations