1. REST API for GoldenGate VeridataREST API for GoldenGate Veridata
  2. Quick Start

Quick Start

Set up your environment and use the REST API to communicate with the GoldenGate Veridata by performing the following tasks.

Prerequisites

Prerequisite More Information

Obtain a GoldenGate Veridata user account.

https://docs.oracle.com/en/middleware/goldengate/veridata/23/gvdug/users.html

Ensure that GoldenGate Veridata 23c server and agent are installed.

https://docs.oracle.com/en/middleware/goldengate/veridata/23/gvdug/installing-and-running-oracle-goldengate-veridata.html

Ensure that you have downloaded and installed JDK 17.

http://www.oracle.com/technetwork/java/javase/downloads/index.html.

  1. Install cURL

    The examples within this document use the cURL command-line tool to demonstrate how to access the Oracle GoldenGate Veridata REST API.

    To connect securely to the server, you must install a version of cURL that supports SSL and provide an SSL certificate authority (CA) certificate file or bundle to authenticate against the Verisign CA certificate. For more information about:

    Using cURL, see Use cURL .

    The following procedure demonstrates how to install cURL on a Linux system:
    1. Install curl using the terminal by running the command sudo apt-get install curl.
    2. Create /usr/local/share/ca-certificates directory, to copy the PEM files.
    3. Copy PEM files to the created directory.
    4. Integrate the certificates into the system's certificate set by running update-ca-certificates.
  2. Understand the Resource URL Format
    You access the Oracle GoldenGate Veridata REST APIs using a URL, which includes the REST endpoint, the resource that you want to access, and any query parameters that you want to include in your request.The basic endpoint for the Oracle GoldenGate Veridata REST API is:
    https://<subdomain>.<domain>.com:<port>/veridata/v1/

    See Send Requests for specific details on building these URLs.

  3. Set Up Authorization

    You need to generate the access token that you can then use to authorize requests that you send to the Oracle GoldenGate Veridata REST API.

    See Authorization.

    You are now ready to send requests to the Oracle GoldenGate Veridata using cURL.