When an Instrument does not have Data , client is expecting to see 204 status code on API response

Question

question

Beera.Rajesh

262 ●8 ●9 ●15

When an Instrument does not have Data , client is expecting to see 204 status code on API response

I ran a Corporate Actions extraction on <EUR=> as there is no such data on that RIC, expected to see 204 status, however I still see 200 Success:

{

"ExtractionRequest": {

"@odata.type": "#ThomsonReuters.Dss.Api.Extractions.ExtractionRequests.CorporateActionsStandardExtractionRequest",

"ContentFieldNames": [

"Corporate Actions Type",

"Capital Change Event Type",

"Capital Change Event Type Description",

"Actual Adjustment Type",

"Actual Adjustment Type Description",

"Adjustment Factor",

"Currency Code",

"Exchange Code",

"Effective Date",

"Dividend Pay Date",

"Dividend Rate",

"Nominal Value",

"Nominal Value Currency",

"Nominal Value Date"

],

"IdentifierList": {

"@odata.type": "#ThomsonReuters.Dss.Api.Extractions.ExtractionRequests.InstrumentIdentifierList",

"InstrumentIdentifiers": [

{ "Identifier": "EUR=", "IdentifierType": "Ric" }

]

},

"Condition": {

"ReportDateRangeType": "Last",

"PreviousDays": 30,

"ExcludeDeletedEvents": true,

"IncludeCapitalChangeEvents": true,

"IncludeDividendEvents": true,

"IncludeEarningsEvents": true,

"IncludeMergersAndAcquisitionsEvents": true,

"IncludeNominalValueEvents": true,

"IncludePublicEquityOfferingsEvents": true,

"IncludeSharesOutstandingEvents": true,

"IncludeVotingRightsEvents": true,

"CorporateActionsCapitalChangeType": "CapitalChangeExDate",

"CorporateActionsDividendsType": "DividendPayDate",

"CorporateActionsEarningsType": "PeriodEndDate",

"ShareAmountTypes": [

]

}

API response:

{

"@odata.context": "https://hosted.datascopeapi.reuters.com/RestApi/v1/$metadata#ThomsonReuters.Dss.Api.Extractions.ExtractionRequests.ExtractionResult",

"Contents": [],

"Notes": [

"Extraction Services Version 14.3.41935 (052f652420ba), Built Oct 12 2020 20:10:50\r\nProcessing started at 11/24/2020 06:53:43.\r\nUser ID: 9022036\r\nExtraction ID: 491676963\r\nSchedule: _OnD_0x0756c43200771104 (ID = 0x0756c43204f71104)\r\nReporting the latest corporate actions.\r\nSuppressing Deleted Events\r\nReporting corporate actions with shares default type.\r\nInput List (1 items): _OnD_0x0756c43200771104 (ID = 0756c43202471104) Created: 11/24/2020 06:53:40 Last Modified: 11/24/2020 06:53:41\r\nSchedule Time: 11/24/2020 06:53:41\r\nReport Template (20 fields): _OnD_0x0756c43200771104 (ID = 0x0756c43200c71104) Created: 11/24/2020 06:53:40 Last Modified: 11/24/2020 06:53:40\r\nProcessing completed successfully at 11/24/2020 06:53:44, taking 0.805 Secs.\r\nExtraction finished at 11/24/2020 06:53:44 UTC, with servers: x03A06, QSHC16 (0.1 secs), QSSHA1 (0.0 secs)\r\nNo usage to report -- 1 Instrument in the input list had no reported data.\r\n"

]

}

Client expecting 204 status as per API documentation:

<https://hosted.datascopeapi.reuters.com/RestApi.Help/Home/StatusCodes>

dss-rest-api datascope-select dss

1606200888850.png (86.2 KiB)

1606200967752.png (107.1 KiB)

Nov 24, 2020 at 07:59 AM

10 |1500

Attachments: Up to 2 attachments (including images) can be used with a maximum of 5.0 MiB each and 10.0 MiB total.

Answer 1 · 2020-11-24T17:13:25Z

zoya faberov

23k ●22 ●9 ●14

Hello @Beera.Rajesh,

In my understanding of DSS Product Documentation of Status Codes , the response status=204 indicates "No Content if the requested resource has the null value.".

The result, in this case, is empty, not null.

So, from my viewpoint, from the API usage perspective, I believe, the request is correct, and I believe the response is correct, as well.

If you would like to verify that the response, as generated by DSS service, is correct, the best approach will be to verify with DSS product team, by submitting a service request to them directly.

Does this answer make sense?

Nov 24, 2020 at 05:13 PM

10 |1500

Attachments: Up to 2 attachments (including images) can be used with a maximum of 5.0 MiB each and 10.0 MiB total.

Beera.Rajesh Nov 25, 2020 at 06:46 AM

@zoya.farberov Thank you for looking into this, may I know an example where clients can expect 204 (where API response will be NULL)

Examples to differentiate : (empty & null)

zoya faberov Beera.Rajesh Nov 25, 2020 at 05:10 PM

Hello @Beera.Rajesh,

Please find a couple of previous discussion threads related to status 204:

previous discussion thread

Another common example of Status=204 is successful deletion from instrument list:

{
                    {protocol}}{
                    {host}}{
                    {api}}Extractions/InstrumentLists('{
                    {listId}}')/ThomsonReuters.Dss.Api.Extractions.InstrumentListDeleteItemsById

result

Status=204, no content

Q&A Forum

question

When an Instrument does not have Data , client is expecting to see 204 status code on API response

1 Answer

question

When an Instrument does not have Data , client is expecting to see 204 status code on API response

1 Answer

Related Questions