401 zero footprint api

ken04
ken04
in World-Check One Zero Footprint

I downloaded the Zero-footprint-api postman collection.

I filled in our apiKey and apiSecret.
Next: getting the top-level groups works.

Entering the id of a top-level group in the environment and performing the Simple Screening request from the postman collection fails.

First: the variables in the url of the request seem to be wrong. It uses the following variables: {
{protocol}}{
{zfs-gateway-host}}{
{zfs-gateway-url}} which are not found in the environment of the postman collection.

Second: I hope to find the correct urls, so looking on this page: https://developers.refinitiv.com/en/api-catalog/customer-and-third-party-screening/world-check-one-zero-footprint-screening-api/quick-start
At the section "Testing Environment" is stated literally:

The typed url states https://api-worldcheck.refinitiv.com/v1/ but the effective hyperlink behind the first part of the text (https://api-worldcheck.refinitiv.com) is https://zfs-world-check-one-api-pilot.thomsonreuters.com/v1/ and behind the second part (/v1/) is https://rms-world-check-one-api-pilot.thomsonreuters.com/v1/
So... which one is it?

Trying in postman it seems to be that the ones with thomsonreuters.com don't exist anymore. So it has to be https://api-worldcheck.refinitiv.com/v1/ ?

(But the image underneath on that page uses thomsonreteuters.com)

If I try with https://api-worldcheck.refinitiv.com/v1/, I receive 401 Unauthorized.

The cURL output of postman is this:

curl --location --request POST 'https://api-worldcheck.refinitiv.com/v1/cases/screeningRequest' \
--header 'Date: Wed, 19 Oct 2022 11:19:20 GMT' \
--header 'Content-Type: application/json' \
--header 'Authorization: Signature keyId="xxxxxx",algorithm="hmac-sha256",headers="(request-target) host date content-type content-length",signature="xxxxxx"' \
--header 'Content-Length: 158' \
--data-raw '{
  "groupId":"5jb86qluue9e1h1fnpqjlhzi9",
  "entityType": "INDIVIDUAL",
  "providerTypes": [
    "WATCHLIST"
  ],
  "name": "putin",
  "secondaryFields":[]
}'


Tagged:

Best Answer

  • virgill.pinas01
    virgill.pinas01
    Answer ✓

    Hi @ken04,

    Thank you for reaching out.


    Please note that our Zero-footprint screening (ZFS) Postman collection have been upgraded to new version including the URLs. The same goes for our World-Check One documentation and further readings.

    To find out more about Zero-footprint screening (ZFS) upgraded collection head to the following link:

    https://developers.refinitiv.com/content/dam/devportal/en_us/product-docs/wc1-api/index.html

    Your developer login credentials should suffice to gain access to the above link.

    After having access to the above link scroll down the page and click on Zero-Footprint Screening - V2 or Zero-Footprint Screening - V1

    Under the heading Sample Use Cases, you will see the link Sample API HTTP requests for ZFS (Postman Collection) - V2 which you need to right-click on and save the link as a JSON file. Further within the text under the heading Sample Use Case repeat the same step as above to download the World-Check One API V2 environment. Import both collection and environment your client application such as Postman.


    Please feel free to reach out if you have further questions.


    Best regards,


    Virgill


Categories