Rapaport Developer Documentation

Introduction

Welcome to Rapaport’s Developer and API & SDK integration guides.  

This platform is a core part of Rapaport’s mission to support our members with diamond pricing information and selling opportunities. 

These documents explain how to connect to Rapaport’s APIs and SDKs, integrate the Rapaport Price Lists in your diamond software, connect your systems or inventory with RapNet,  and use RapNet Instant Inventory to showcase diamonds and/or jewelry in your online store.

API and SDK Overview

To get the most value out of RapNet, our APIs and SDKs are designed to allow companies of any shape or size to build robust integrations into their software, website, or RapNet itself.  

We offer both APIs and Software Development Kits (SDKs) as methods for integrating development software.

Rapaport APIs:

Rapaport SDK Packages:

Note: To use our APIs or SDKs, you will need to subscribe to a paid Rapaport plan and have a Login Token. 

Login Token Requirements

To use our new API codes or SDK packages, you will need to create a Login Token.   The Login Token works with API credentials which you can activate from your RapNet account.

Create the Login Token

  1. Go to RapNet API Access.
  2. Activate Your API Credentials which contain a Client ID and Client Secret.
  3. Copy and insert these credentials to use when creating the token.  See example:
  4. Copy the Token response and place it the Authorization Tab of your API.
				
					POST /api/get HTTP/1.1
Host: authztoken.api.rapaport.com
Content-Type: application/json
Content-Length: 142

{
    "client_id":"s78qaoOd9efr5dQm9hsX3gZC4jKxnnKS",
    "client_secret":"B-4kr4b2nwonivo08tb-Z6B-L7sNJkjDnyZMGPbGbCvpfRcRf5FyGdKGoZaMd3gm"
}
				
			
Token -Response
				
					{
    "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6Ik16aERRMFExTURFeVJqSTNRa0k0TTBGRVJUZzFNekUzTWtOQ09UTXhNREZDTVVZM1JURkNNZyJ9.eyJodHRwOi8vcmFwYXBvcnQuY29tL3VzZXIiOnsiYWNjb3VudElkIjoxMTUwNzR9LCJodHRwOi8vcmFwYXBvcnQuY29tL3Njb3BlIjpbInByaWNlTGlzdFdlZWtseSIsImluc3RhbnRJbnZlbnRvcnkiLCJtYW5hZ2VMaXN0aW5ncyJdLCJodHRwOi8vcmFwYXBvcnQuY29tL2FwaWtleSI6eyJodHRwczovL2luc3RhbnRpbnZlbnRvcnkucmFwbmV0YXBpcy5jb20iOiJjWHZoZ3l3UTVwNDByb1Z0eTFCbzUyMUNUNkF3UUhLSjh5OGVFcTF5IiwiaHR0cHM6Ly9tZWRpYXVwbG9hZC5yYXBuZXRhcGlzLmNvbSI6ImxsMldoc2NuV3k5RGl6QUREV25INjlRcXRRblQ4eGdjMzVoUTN5RnAiLCJodHRwczovL3ByaWNlbGlzdC5yYXBuZXRhcGlzLmNvbSI6ImNkenM5dTZFZkI3eXI1MGxGcnpzT2FDYVZkQjdvckFSMnJGSlVnT3IiLCJodHRwczovL3VwbG9hZGxvdHMucmFwbmV0YXBpcy5jb20iOiJwejl2c0hCc3NrM2xWT1R1eTRNUVM1WkhoRFpwUjgwVjkzTnFuRGY2In0sImh0dHA6Ly9yYXBhcG9ydC5jb20vYXVkaWVuY2UiOlsiaHR0cHM6Ly91cGxvYWRsb3RzLnJhcG5ldGFwaXMuY29tIiwiaHR0cHM6Ly9pbnN0YW50aW52ZW50b3J5LnJhcG5ldGFwaXMuY29tIiwiaHR0cHM6Ly9wcmljZWxpc3QucmFwbmV0YXBpcy5jb20iLCJodHRwczovL21lZGlhdXBsb2FkLnJhcG5ldGFwaXMuY29tIiwiaHR0cHM6Ly9hcGlnYXRld2F5LnJhcG5ldGFwaXMuY29tIl0sImh0dHA6Ly9yYXBhcG9ydC5jb20vcGVybWlzc2lvbnMiOnsicmFwbmV0YXBpcy1hcGlnYXRld2F5IjpbInByaW1hcnlTdXBsbGllciIsInByaWNlTGlzdFdlZWtseSIsImVudGVycHJpc2UiLCJwcmljZUxpc3RNb250aGx5IiwicmFwbmV0UHJpY2VMaXN0V2Vla2x5IiwiYmFzaWMiLCJyYXBhcG9ydEVtcGxveWVlcyIsIkRMUyIsInJhcG5ldFByaWNlTGlzdE1vbnRobHkiLCJiZXRhIiwiaW5zdGFudEludmVudG9yeSIsIm1lbWJlckRpcmVjdG9yeSIsInNlYXJjaCIsImluc3RhbnRJbnZlbnRvcnlTZXR1cCIsIm1hbmFnZUxpc3RpbmdzRmlsZSIsImJ1eVJlcXVlc3RzQWRkIiwiaXRlbVNoYXJlZCIsInRyYWRlQ2VudGVyIiwibXlDb250YWN0cyIsIm1lbWJlclJhdGluZyIsImNoYXQiLCJtYW5hZ2VMaXN0aW5ncyIsImxlYWRzIiwiYWRtaW4iLCJidXlSZXF1ZXN0cyJdfSwiaXNzIjoiaHR0cHM6Ly9yYXBhcG9ydC5hdXRoMC5jb20vIiwic3ViIjoiZ1Vja0lRejBSaEVqQ0R4Z2ZOenUyNE5zd3M2NGo5VXBAY2xpZW50cyIsImF1ZCI6Imh0dHBzOi8vYXBpZ2F0ZXdheS5yYXBuZXRhcGlzLmNvbSIsImlhdCI6MTcwODIwODUyOSwiZXhwIjoxNzA4Mjk0OTI5LCJhenAiOiJnVWNrSVF6MFJoRWpDRHhnZk56dTI0TnN3czY0ajlVcCIsInNjb3BlIjoiYXBpR2F0ZXdheSIsImd0eSI6ImNsaWVudC1jcmVkZW50aWFscyJ9.OzPeC6iAiUQtPKreRVElt4had4zLkBsH9uTUOtwe9fE_99YM1GkouMmuwAUwXn1JptrUGLhv-VwtxvI_MnVLpRVMw2P7rcFtnQ1QPQJNxuar73vXTrORKP0i3nRnyNrsacKhi5KAMBlSVO-JmgAUHbJM5C42cpjG0c4GneZym1WlnErX8Ly2OrTGa3wjwZN3qIIaygjn0Fxrk0c11eNhFXeBqC_C1E3ViiRlNMM9FXRM-nwy9ZJ9DOvWU-IRURQsvmv7awEX-U1hzVPxBaI6JG894EYBkS_BYcl5aOvFxneGMT2hHUQ3yJTnmO9AD58p4HWzv5dOIcnWY9AnX32z_w",
    "scope": "apiGateway",
    "expires_in": 43825,
    "token_type": "Bearer"
}
				
			
Place Bearer Token

API & SDK Integration

API

Click on the API that you wish to use:

SDK

Choose and download one of the SDK packages below, then click to go to the SDK code you require:

 

SDK Packages

To use a specific Software Development Kit, there are 3 steps.

  1. Activate your API Credentials.
  2. Create your Login Token – as explained above.
  3. Download your required SDK package.
  4. Choose from the menu and go to the corresponding SDK.  

SDK Package Download

Install package:

composer require rapnet/price_list

Initialize:

use Rapnet\RapnetPriceList\Index;

require_once './vendor/autoload.php';

Get token:

$pricelist  = new Index($clientId, $clientSecret);

$token = $pricelist->createAuthorizationCodeToken()

Install package:

npm  js_jewelry_routers_pack

Initialize:

import jewelryRouters from 'js_jewelry_routers_pack';

Get token:

token = jewelryRouters.getAuthToken(authCode, cliantId, secret, userRedirectUrl)

Install package:

composer require rapnet/instant_inventory

Initialize:

use Rapnet\RapnetInstantInventory\Index;

require_once './vendor/autoload.php';

Get token:

$iinventory  = new Index($clientId, $clientSecret);

$token = $iinventory->createAuthorizationCodeToken()

Install package:

npm  js_jewelry_routers_pack

Initialize:

import jewelryRouters from 'js_jewelry_routers_pack';

Get token:

token = jewelryRouters.getAuthToken(authCode, cliantId, secret, userRedirectUrl)

Install package:

composer require rapnet/rapnet_media_upload

This will install package with production environment values, but if you want to have another environment values you can run script manually

composer run-script build-dev 

composer run-script build-stage

Initialize:

use Rapnet\RapnetMediaUpload\Index;

require_once './vendor/autoload.php';

Get token:

$media  = new Index($clientId, $clientSecret);

$token = $media->createAuthorizationCodeToken()

Install package:

npm  js_jewelry_routers_pack

Initialize:

import jewelryRouters from 'js_jewelry_routers_pack';

Get token:

token = jewelryRouters.getAuthToken(authCode, cliantId, secret, userRedirectUrl)

Links & Help Articles

Accessibility