(Visual FoxPro) Firebase POST - Pushing Data (JSON Object)

Uses the POST method to append a new record (JSON Object) at a particular location in the database. Firebase automatically generates the push ID and returns it in the response. The data used in this example is at Chilkat Firebase Pigs Database, and is shown here:

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

LOCAL loFac
LOCAL lcAccessToken
LOCAL loRest
LOCAL lnSuccess
LOCAL loAuthGoogle
LOCAL loPigRecord
LOCAL lcJsonResponse
LOCAL loResp
LOCAL lcPushId

* Push a new record to a Firebase JSON database using the POST HTTP method.

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

* This example assumes a JWT authentication token, if required, has been previously obtained.
* See Get Firebase Access Token from JSON Service Account Private Key for sample code.

* Load the previously obtained Firebase access token into a string.
* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.FileAccess')
loFac = CreateObject('Chilkat.FileAccess')
lcAccessToken = loFac.ReadEntireTextFile("qa_data/tokens/firebaseToken.txt","utf-8")
IF (loFac.LastMethodSuccess <> 1) THEN
    ? loFac.LastErrorText
    RELEASE loFac
    CANCEL
ENDIF

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

* Make the initial connection (without sending a request yet).
* Once connected, any number of requests may be sent.  It is not necessary to explicitly
* call Connect before each request.  
lnSuccess = loRest.Connect("chilkat.firebaseio.com",443,1,1)
IF (lnSuccess <> 1) THEN
    ? loRest.LastErrorText
    RELEASE loFac
    RELEASE loRest
    CANCEL
ENDIF

* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.AuthGoogle')
loAuthGoogle = CreateObject('Chilkat.AuthGoogle')
loAuthGoogle.AccessToken = lcAccessToken
loRest.SetAuthGoogle(loAuthGoogle)

* Chilkat's sample data (pig-rescue data) is publicly readable at: https://chilkat.firebaseio.com/.json
* This data is publicly readable, but not writable.  You'll need to 
* run against your own database..

* We're going to add a new pig with four name/value pairs:
* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.JsonObject')
loPigRecord = CreateObject('Chilkat.JsonObject')
loPigRecord.AppendString("name","William")
loPigRecord.AppendString("species","pot belly pig")
loPigRecord.AppendString("type","Mike's Herd")
loPigRecord.AppendString("birth","March, 2001")

lcJsonResponse = loRest.FullRequestString("POST","/pig-rescue/animal.json",loPigRecord.Emit())
IF (loRest.LastMethodSuccess <> 1) THEN
    * Something happened in the communications (either no request was sent, or no response was received.
    * (The Chilkat REST API also has lower-level methods where an app can send the request in one call,
    * and then receive the response in another call.)
    ? loRest.LastErrorText
    RELEASE loFac
    RELEASE loRest
    RELEASE loAuthGoogle
    RELEASE loPigRecord
    CANCEL
ENDIF

* Check the response status code.   A 200 response status indicates success.
IF (loRest.ResponseStatusCode <> 200) THEN
    ? loRest.ResponseStatusText
    ? lcJsonResponse
    ? "Failed."
    RELEASE loFac
    RELEASE loRest
    RELEASE loAuthGoogle
    RELEASE loPigRecord
    CANCEL
ENDIF

* Get the push ID generated by Firebase
* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.JsonObject')
loResp = CreateObject('Chilkat.JsonObject')
loResp.Load(lcJsonResponse)
lcPushId = loResp.StringOf("name")
? "Added record with push ID " + lcPushId
? "Success."

RELEASE loFac
RELEASE loRest
RELEASE loAuthGoogle
RELEASE loPigRecord
RELEASE loResp