(Visual FoxPro) Yousign Procedure Creation Basic Mode Upload File

Demonstrates the 1st step of Yousign procedure creation, which is to upload a PDF file.

For more information, see https://dev.yousign.com/?version=latest#0889a9c5-aa1e-4de0-9b35-4d6621b4eb20

Chilkat ActiveX Downloads ActiveX for 32-bit and 64-bit Windows

LOCAL loHttp
LOCAL lnSuccess
LOCAL loPdfData
LOCAL loJson
LOCAL loResp
LOCAL loSbResponseBody
LOCAL loJResp
LOCAL lnRespStatusCode
LOCAL lcId
LOCAL lcName
LOCAL lcV_type
LOCAL lcContentType
LOCAL lcDescription
LOCAL lcCreatedAt
LOCAL lcUpdatedAt
LOCAL lcSha256
LOCAL lcWorkspace
LOCAL lcCreator
LOCAL lnV_protected
LOCAL lnPosition
LOCAL lcParent
LOCAL i
LOCAL lnCount_i

* This example assumes the Chilkat API to have been previously unlocked.
* See Global Unlock Sample for sample code.

* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.Http')
loHttp = CreateObject('Chilkat.Http')

* Implements the following CURL command:

* curl --location --request POST 'https://staging-api.yousign.com/files' \
* --header 'Authorization: Bearer YOUR_API_KEY' \
* --header 'Content-Type: application/json' \
* --data-raw '{
*     "name": "The best name for my file.pdf",
*     "content": "JVBERi0..." }'

* Load a PDF file to be uploaded.
* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.BinData')
loPdfData = CreateObject('Chilkat.BinData')
lnSuccess = loPdfData.LoadFile("qa_data/pdf/helloWorld.pdf")
IF (lnSuccess = 0) THEN
    ? "Failed to load PDF local file."
    RELEASE loHttp
    RELEASE loPdfData
    CANCEL
ENDIF

* Use the following online tool to generate HTTP code from a CURL command
* Convert a cURL Command to HTTP Source Code

* Use this online tool to generate code from sample JSON:
* Generate Code to Create JSON

* The following JSON is sent in the request body.

* {
*   "name": "The best name for my file.pdf",
*   "content": "JVBERi0..."
* }

* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.JsonObject')
loJson = CreateObject('Chilkat.JsonObject')
loJson.UpdateString("name","helloWorld.pdf")
loJson.UpdateString("content",loPdfData.GetEncoded("base64"))

* Adds the "Authorization: Bearer YOUR_API_KEY" header.
loHttp.AuthToken = "YOUR_API_KEY"
loHttp.SetRequestHeader("Content-Type","application/json")

loResp = loHttp.PostJson3("https://staging-api.yousign.com/files","application/json",loJson)
IF (loHttp.LastMethodSuccess = 0) THEN
    ? loHttp.LastErrorText
    RELEASE loHttp
    RELEASE loPdfData
    RELEASE loJson
    CANCEL
ENDIF

* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.StringBuilder')
loSbResponseBody = CreateObject('Chilkat.StringBuilder')
loResp.GetBodySb(loSbResponseBody)
* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.JsonObject')
loJResp = CreateObject('Chilkat.JsonObject')
loJResp.LoadSb(loSbResponseBody)
loJResp.EmitCompact = 0

? "Response Body:"
? loJResp.Emit()

lnRespStatusCode = loResp.StatusCode
? "Response Status Code = " + STR(lnRespStatusCode)
IF (lnRespStatusCode >= 400) THEN
    ? "Response Header:"
    ? loResp.Header
    ? "Failed."
    RELEASE loResp
    RELEASE loHttp
    RELEASE loPdfData
    RELEASE loJson
    RELEASE loSbResponseBody
    RELEASE loJResp
    CANCEL
ENDIF

RELEASE loResp

* Sample JSON response:
* (Sample code for parsing the JSON response is shown below)

* {
*   "id": "/files/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
*   "name": "The best name for my file.pdf",
*   "type": "signable",
*   "contentType": "application/pdf",
*   "description": null,
*   "createdAt": "2018-12-01T11:36:20+01:00",
*   "updatedAt": "2018-12-01T11:36:20+01:00",
*   "sha256": "bb57ae2b2ca6ad0133a699350d1a6f6c8cdfde3cf872cf526585d306e4675cc2",
*   "metadata": [
*   ],
*   "workspace": "/workspaces/XXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
*   "creator": null,
*   "protected": false,
*   "position": 0,
*   "parent": null
* }

* Sample code for parsing the JSON response...
* Use the following online tool to generate parsing code from sample JSON:
* Generate Parsing Code from JSON

lcId = loJResp.StringOf("id")
lcName = loJResp.StringOf("name")
lcV_type = loJResp.StringOf("type")
lcContentType = loJResp.StringOf("contentType")
lcDescription = loJResp.StringOf("description")
lcCreatedAt = loJResp.StringOf("createdAt")
lcUpdatedAt = loJResp.StringOf("updatedAt")
lcSha256 = loJResp.StringOf("sha256")
lcWorkspace = loJResp.StringOf("workspace")
lcCreator = loJResp.StringOf("creator")
lnV_protected = loJResp.BoolOf("protected")
lnPosition = loJResp.IntOf("position")
lcParent = loJResp.StringOf("parent")
i = 0
lnCount_i = loJResp.SizeOfArray("metadata")
DO WHILE i < lnCount_i
    loJResp.I = i
    i = i + 1
ENDDO

RELEASE loHttp
RELEASE loPdfData
RELEASE loJson
RELEASE loSbResponseBody
RELEASE loJResp