Received Files - Fetch

Retrieve Dropbox received files using SQL Server

Prerequisites:

See SQLHTTP easy setup for Dropbox
See API Call documentation for parameter values and other information
Create the stored procedure documented below

Stored Procedure:


CREATE PROCEDURE usp_DropBox_v2_Received_Files_Fetch(	
		@Profile nvarchar(100),
		@Body varchar(MAX),
		@Cursor nvarchar(MAX) = NULL,
		@Response nvarchar(MAX) OUTPUT,
		@StatusCode int OUTPUT,
		@StatusDescription nvarchar(MAX) OUTPUT)
AS

DECLARE @URL nvarchar(MAX)
DECLARE @HTTPSessionID uniqueidentifier

SET @URL = 'https://api.dropbox.com/2'

IF @Cursor IS NULL
	BEGIN
		EXEC SQLHTTP.net.UrlBuilder @URL OUTPUT,
					    @Profile,
					    'sharing', 'list_received_files'
	END
ELSE
	BEGIN
		EXEC SQLHTTP.net.UrlBuilder @URL OUTPUT,
					    @Profile,
					    'sharing', 'list_received_files', 'continue'

		SET @Body = '{
			"cursor": "' + @Cursor + '"
		    }'
	END

EXEC SQLHTTP.net.HTTPSession @HTTPSessionID OUTPUT

EXEC usp_Dropbox_v2_Auth_Header @Profile, @HTTPSessionID

EXEC SQLHTTP.net.HTTPRequest 	@HttpSessionID,
				@URL = @URL,
				@Method = 'POST',
				@Body = @Body,
				@ContentType = 'application/json',
				@StatusCode = @StatusCode OUTPUT,
				@StatusDescription = @StatusDescription OUTPUT,
				@Response = @Response OUTPUT
GO

CREATE PROCEDURE usp_DropBox_v2_Received_Files_Fetch(

@Profile nvarchar(100),

@Body varchar(MAX),

@Cursor nvarchar(MAX) = NULL,

@Response nvarchar(MAX) OUTPUT,

@StatusCode int OUTPUT,

@StatusDescription nvarchar(MAX) OUTPUT)

DECLARE @URL nvarchar(MAX)

DECLARE @HTTPSessionID uniqueidentifier

SET @URL = 'https://api.dropbox.com/2'

IF @Cursor IS NULL

BEGIN

EXEC SQLHTTP.net.UrlBuilder @URL OUTPUT,

@Profile,

'sharing', 'list_received_files'

END

ELSE

BEGIN

EXEC SQLHTTP.net.UrlBuilder @URL OUTPUT,

@Profile,

'sharing', 'list_received_files', 'continue'

SET @Body = '{

"cursor": "' + @Cursor + '"

END

EXEC SQLHTTP.net.HTTPSession @HTTPSessionID OUTPUT

EXEC usp_Dropbox_v2_Auth_Header @Profile, @HTTPSessionID

EXEC SQLHTTP.net.HTTPRequest @HttpSessionID,

@URL = @URL,

@Method = 'POST',

@Body = @Body,

@ContentType = 'application/json',

@StatusCode = @StatusCode OUTPUT,

@StatusDescription = @StatusDescription OUTPUT,

@Response = @Response OUTPUT



Sample Usage:


DECLARE @Response nvarchar(MAX)
DECLARE @StatusCode int
DECLARE @StatusDescription nvarchar(MAX)
DECLARE @Body varchar(MAX)

SET @Body = '{
    "limit": 100,
    "actions": []
}'

EXEC usp_DropBox_v2_Received_Files_Fetch
		@Profile = 'My Dropbox',
		@Body = @Body,
		@Cursor = NULL,
		@Response= @Response OUTPUT,
		@StatusCode = @StatusCode OUTPUT, 
		@StatusDescription = @StatusDescription OUTPUT

IF @StatusCode >= 400
	EXEC SQLHTTP.net.RaiseHttpError @StatusCode, @StatusDescription, @Response
ELSE
	BEGIN
		
		DECLARE @X xml
		SET @X = SQLHTTP.net.Json_To_Xml(@Response, '0')

		--The XPath syntax below was easily generated by executing the following commands:
		--EXEC SQLHTTP.net.XQueryHelper @X
		--and then executing: 
		--EXEC SQLHTTP.net.XQueryHelper @X, 'JsonObject/entries/JsonObject' -- list received files
		--EXEC SQLHTTP.net.XQueryHelper @X, 'JsonObject' -- cursor

		SELECT T.C.value(N'@id', N'nvarchar(MAX)') AS [id]
		      ,T.C.value(N'@name', N'nvarchar(MAX)') AS [name]
		      ,T.C.value(N'@preview_url', N'nvarchar(MAX)') AS [preview_url]
		      ,T.C.value(N'access_type[1]/@_x002E_tag', N'nvarchar(MAX)') AS [access_type_.tag]
		FROM @X.nodes(N'/JsonObject/entries/JsonObject') T(C)

		--Set @Cursor parameter to the below value of @cursor
		--and continue calling the above stored procedure to load additional received files

		DECLARE @cursor nvarchar(MAX)

		SELECT @cursor = T.C.value(N'@cursor', N'nvarchar(MAX)')
		FROM @X.nodes(N'/JsonObject') T(C)

	END

DECLARE @Response nvarchar(MAX)

DECLARE @StatusCode int

DECLARE @StatusDescription nvarchar(MAX)

DECLARE @Body varchar(MAX)

SET @Body = '{

"limit": 100,

"actions": []

EXEC usp_DropBox_v2_Received_Files_Fetch

@Profile = 'My Dropbox',

@Body = @Body,

@Cursor = NULL,

@Response= @Response OUTPUT,

@StatusCode = @StatusCode OUTPUT,

@StatusDescription = @StatusDescription OUTPUT

IF @StatusCode >= 400

EXEC SQLHTTP.net.RaiseHttpError @StatusCode, @StatusDescription, @Response

ELSE

BEGIN

DECLARE @X xml

SET @X = SQLHTTP.net.Json_To_Xml(@Response, '0')

--The XPath syntax below was easily generated by executing the following commands:

--EXEC SQLHTTP.net.XQueryHelper @X

--and then executing:

--EXEC SQLHTTP.net.XQueryHelper @X, 'JsonObject/entries/JsonObject' -- list received files

--EXEC SQLHTTP.net.XQueryHelper @X, 'JsonObject' -- cursor

SELECT T.C.value(N'@id', N'nvarchar(MAX)') AS [id]

,T.C.value(N'@name', N'nvarchar(MAX)') AS [name]

,T.C.value(N'@preview_url', N'nvarchar(MAX)') AS [preview_url]

,T.C.value(N'access_type[1]/@_x002E_tag', N'nvarchar(MAX)') AS [access_type_.tag]

FROM @X.nodes(N'/JsonObject/entries/JsonObject') T(C)

--Set @Cursor parameter to the below value of @cursor

--and continue calling the above stored procedure to load additional received files

DECLARE @cursor nvarchar(MAX)

SELECT @cursor = T.C.value(N'@cursor', N'nvarchar(MAX)')

FROM @X.nodes(N'/JsonObject') T(C)

END

id name preview_url access_type_.tag

------------------ --------------- ---------------------------------------- -----------------

id:CAI9Uyyv3xA... Dropbox.pdf https://www.dropbox.com/scl/fi/pnu7p... owner

id:CAI9Uyyv3xA... SampleFile.doc https://www.dropbox.com/scl/fi/1c698... owner



IMPORTANT DISCLAIMER

CODE/SQL ON THESE PAGES ARE PROVIDED AS-IS AND ARE AVAILABLE FOR ILLUSTRATIVE PURPOSES ONLY.

USERS ARE REQUIRED TO ABIDE BY THE TERMS AND CONDITIONS FOR USING REFERENCED THIRD PARTY WEBSITES AND/OR APIs FROM THEIR RESPECTIVE WEBSITES. WE DO NOT CONDONE ANY VIOLATION OF THIRD PARTY WEBSITES AND/OR APIs TERMS AND CONDITIONS USING OUR SOFTWARE.

USERS SHALL BE SOLELY RESPONSIBLE AND BE SOLELY LIABLE FOR VIOLATION OF ANY RULES SPECIFIED BY THIRD PARTIES FOR USING THEIR WEBSITES AND/OR APIs, OR INFRINGEMENT OF RIGHTS OF SUCH THIRD PARTIES.