question

Upvotes
Accepted
ken04 avatar image
3 ●0 ●0 ●2

401 zero footprint api

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":[]
}'


world-check-oneapiworld-check-one-zfdocumentation
icon clock
10 |1500

Up to 2 attachments (including images) can be used with a maximum of 512.0 KiB each and 1.0 MiB total.

raksina.samasiri avatar image   raksina.samasiri

<AHS>

original curl output

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="a70a8a13-337e-4c67-ac58-38f3e0c5a9e1",algorithm="hmac-sha256",headers="(request-target) host date content-type content-length",signature="TZBFmY4MqWTDf99HRZ1FgFP/i0KRqoE03mmdjrgCslk="' \
--header 'Content-Length: 158' \
--data-raw '{
  "groupId":"5jb86qluue9e1h1fnpqjlhzi9",
  "entityType": "INDIVIDUAL",
  "providerTypes": [
    "WATCHLIST"
  ],
  "name": "putin",
  "secondaryFields":[]
}'
raksina.samasiri avatar image   raksina.samasiri
hi @ken04 ,

please be informed that the authorization was removed from the original post regarding the security concern.

Thanks,
AHS

zoya faberov avatar image   zoya faberov

Hello @ken04 ,

Thank you for your participation in the forum.

Is the reply below satisfactory in resolving your query?

If so please can you click the 'Accept' text next to the appropriate reply. This will guide all community members who have a similar question.

Thanks

-AHS

1 Answer

· Write an Answer
Upvotes
Accepted
virgill.pinas01 avatar image
618 ●2 ●0 ●2

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


icon clock
10 |1500

Up to 2 attachments (including images) can be used with a maximum of 512.0 KiB each and 1.0 MiB total.

Write an Answer

Hint: Notify or tag a user in this post by typing @username.

Up to 2 attachments (including images) can be used with a maximum of 512.0 KiB each and 1.0 MiB total.