(Tcl) Firebase POST - Pushing Data

Uses the POST method to append a new record 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 Tcl Extension Downloads Chilkat Tcl Extension Downloads

load ./chilkat.dll

# 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.
set fac [new_CkFileAccess]

set accessToken [CkFileAccess_readEntireTextFile $fac "qa_data/tokens/firebaseToken.txt" "utf-8"]
if {[CkFileAccess_get_LastMethodSuccess $fac] != 1} then {
    puts [CkFileAccess_lastErrorText $fac]
    delete_CkFileAccess $fac
    exit
}

set rest [new_CkRest]

# 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.  
set success [CkRest_Connect $rest "chilkat.firebaseio.com" 443 1 1]
if {$success != 1} then {
    puts [CkRest_lastErrorText $rest]
    delete_CkFileAccess $fac
    delete_CkRest $rest
    exit
}

set authGoogle [new_CkAuthGoogle]

CkAuthGoogle_put_AccessToken $authGoogle $accessToken
CkRest_SetAuthGoogle $rest $authGoogle

# 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 just the name.
set pigRecord [new_CkJsonObject]

CkJsonObject_AppendString $pigRecord "name" "William"

# The string content of the last arg passed is  {"name":"William"} 
set jsonResponse [CkRest_fullRequestString $rest "POST" "/pig-rescue/animal.json" [CkJsonObject_emit $pigRecord]]
if {[CkRest_get_LastMethodSuccess $rest] != 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.)
    puts [CkRest_lastErrorText $rest]
    delete_CkFileAccess $fac
    delete_CkRest $rest
    delete_CkAuthGoogle $authGoogle
    delete_CkJsonObject $pigRecord
    exit
}

# Check the response status code.   A 200 response status indicates success.
if {[CkRest_get_ResponseStatusCode $rest] != 200} then {
    puts [CkRest_responseStatusText $rest]
    puts "$jsonResponse"
    puts "Failed."
    delete_CkFileAccess $fac
    delete_CkRest $rest
    delete_CkAuthGoogle $authGoogle
    delete_CkJsonObject $pigRecord
    exit
}

# Get the push ID generated by Firebase
set resp [new_CkJsonObject]

CkJsonObject_Load $resp $jsonResponse
set pushId [CkJsonObject_stringOf $resp "name"]
puts "Added record with push ID $pushId"
puts "Success."

delete_CkFileAccess $fac
delete_CkRest $rest
delete_CkAuthGoogle $authGoogle
delete_CkJsonObject $pigRecord
delete_CkJsonObject $resp