File Thumbnail - Fetch

Retrieve a thumbnail image for a specific file in a Box.com account using SQL Server

Prerequisites:

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

Stored Procedure:


CREATE PROCEDURE usp_Box_v2_FileThumbnail_Fetch(	
		@Profile nvarchar(100),
		@FileID bigint,
		@min_height bigint = NULL,
		@min_width bigint = NULL,
		@max_height bigint = NULL,
		@max_width bigint = NULL,
		@Response nvarchar(MAX) OUTPUT,
		@StatusCode int OUTPUT,
		@StatusDescription nvarchar(MAX) OUTPUT)
AS

DECLARE @URL nvarchar(MAX)
DECLARE @QueryString varchar(MAX)
DECLARE @HTTPSessionID uniqueidentifier

SET @URL = 'https://api.box.com/2.0'

EXEC SQLHTTP.net.UrlBuilder   @URL OUTPUT,
			      @Profile,
			      'files', @FileID ,'thumbnail.jpg'

EXEC SQLHTTP.net.QueryStringBuilder   @QueryString OUTPUT,
				      @Profile,
				      'min_height', @min_height,
				      'min_width', @min_width,
				      'max_height', @max_height,
				      'max_width', @max_width

SET @URL = @URL + @QueryString

EXEC SQLHTTP.net.HTTPSession @HTTPSessionID OUTPUT

EXEC usp_Box_v2_Auth_Header @Profile, @HTTPSessionID

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

GO

CREATE PROCEDURE usp_Box_v2_FileThumbnail_Fetch(

@Profile nvarchar(100),

@FileID bigint,

@min_height bigint = NULL,

@min_width bigint = NULL,

@max_height bigint = NULL,

@max_width bigint = NULL,

@Response nvarchar(MAX) OUTPUT,

@StatusCode int OUTPUT,

@StatusDescription nvarchar(MAX) OUTPUT)

DECLARE @URL nvarchar(MAX)

DECLARE @QueryString varchar(MAX)

DECLARE @HTTPSessionID uniqueidentifier

SET @URL = 'https://api.box.com/2.0'

EXEC SQLHTTP.net.UrlBuilder @URL OUTPUT,

@Profile,

'files', @FileID ,'thumbnail.jpg'

EXEC SQLHTTP.net.QueryStringBuilder @QueryString OUTPUT,

@Profile,

'min_height', @min_height,

'min_width', @min_width,

'max_height', @max_height,

'max_width', @max_width

SET @URL = @URL + @QueryString

EXEC SQLHTTP.net.HTTPSession @HTTPSessionID OUTPUT

EXEC usp_Box_v2_Auth_Header @Profile, @HTTPSessionID

EXEC SQLHTTP.net.HTTPRequest @HttpSessionID,

@URL = @URL,

@Method = 'GET',

@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 @Profile nvarchar(100)

SET @Profile = 'My Box'

--Box.com Oauth2 is token is valid for only one hour
EXEC usp_Box_v2_Auth_Refresh @Profile

EXEC usp_Box_v2_FileThumbnail_Fetch
	@Profile = @Profile,
	@FileID ='172994141665',
	@min_height = 256,
	@min_width = 256,
	@Response= @Response OUTPUT,
	@StatusCode = @StatusCode OUTPUT, 
	@StatusDescription = @StatusDescription OUTPUT

SELECT  @StatusCode AS StatusCode, 
        @StatusDescription AS StatusDescription

DECLARE @Response nvarchar(MAX)

DECLARE @StatusCode int

DECLARE @StatusDescription nvarchar(MAX)

DECLARE @Profile nvarchar(100)

SET @Profile = 'My Box'

--Box.com Oauth2 is token is valid for only one hour

EXEC usp_Box_v2_Auth_Refresh @Profile

EXEC usp_Box_v2_FileThumbnail_Fetch

@Profile = @Profile,

@FileID ='172994141665',

@min_height = 256,

@min_width = 256,

@Response= @Response OUTPUT,

@StatusCode = @StatusCode OUTPUT,

@StatusDescription = @StatusDescription OUTPUT

SELECT @StatusCode AS StatusCode,

@StatusDescription AS StatusDescription

StatusCode StatusDescription

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

200 OK



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.