WIPO Pearl | Terminology

The WIPO Pearl Application Programming Interface (API) is a secure machine-to-machine REST API that enables your applications automatically to connect to and benefit from WIPO Pearl terminology information and functionalities. Security is enforced via an HTTPS TLS 1.2 encrypted channel and an API key.

REQUESTING ACCESS TO THE API

To start using the API, you first need to submit a WIPO Pearl API Request Form.

We will then contact you by email to validate your request. Once your request is approved, you will need to create a pair of keys which will be used to receive the API key securely.

You will obtain access to the WIPO Pearl API via this API key, which will enable your applications to use the WIPO Pearl API and benefit from WIPO Pearl terminology information and functionalities.

RECEIVING THE API KEY

In order to receive the API key securely by email from us, you will need to create a pair of keys using the openssl tool:

openssl genrsa -out yoursecretkey.pem 4096

openssl rsa -in yoursecretkey.pem -pubout > yourpublickey.pub

The secret key remains secure on your server, but you must send us the public key in reply to the email that we will send you. When we receive the public key from you, we will send you the API key, which will be encrypted using your public key. You can then decrypt the information using your secret key so as to retrieve the API key:

openssl rsautl -decrypt -in wipopearl_encrypted_key -out plainTextKey.txt -inkey yoursecretkey.pem

OBTAINING ACCESS TO THE API

To obtain access to the WIPO Pearl API, your application needs to provide the “x-api-key” header in all API calls, and a value for this header corresponding to the “plainTextKey.txt”.