PureBasic

Firebase POST - Pushing Data

See more Firebase Examples

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:

PureBasic

IncludeFile "CkAuthGoogle.pb"
IncludeFile "CkRest.pb"
IncludeFile "CkJsonObject.pb"
IncludeFile "CkFileAccess.pb"

Procedure ChilkatExample()

    success.i = 0

    ; 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.
    fac.i = CkFileAccess::ckCreate()
    If fac.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    accessToken.s = CkFileAccess::ckReadEntireTextFile(fac,"qa_data/tokens/firebaseToken.txt","utf-8")
    If CkFileAccess::ckLastMethodSuccess(fac) <> 1
        Debug CkFileAccess::ckLastErrorText(fac)
        CkFileAccess::ckDispose(fac)
        ProcedureReturn
    EndIf

    rest.i = CkRest::ckCreate()
    If rest.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    ; 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.  
    success = CkRest::ckConnect(rest,"chilkat.firebaseio.com",443,1,1)
    If success <> 1
        Debug CkRest::ckLastErrorText(rest)
        CkFileAccess::ckDispose(fac)
        CkRest::ckDispose(rest)
        ProcedureReturn
    EndIf

    authGoogle.i = CkAuthGoogle::ckCreate()
    If authGoogle.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkAuthGoogle::setCkAccessToken(authGoogle, accessToken)
    CkRest::ckSetAuthGoogle(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.
    pigRecord.i = CkJsonObject::ckCreate()
    If pigRecord.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkJsonObject::ckAppendString(pigRecord,"name","William")

    ; The string content of the last arg passed is  {"name":"William"} 
    jsonResponse.s = CkRest::ckFullRequestString(rest,"POST","/pig-rescue/animal.json",CkJsonObject::ckEmit(pigRecord))
    If CkRest::ckLastMethodSuccess(rest) <> 1
        ; 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.)
        Debug CkRest::ckLastErrorText(rest)
        CkFileAccess::ckDispose(fac)
        CkRest::ckDispose(rest)
        CkAuthGoogle::ckDispose(authGoogle)
        CkJsonObject::ckDispose(pigRecord)
        ProcedureReturn
    EndIf

    ; Check the response status code.   A 200 response status indicates success.
    If CkRest::ckResponseStatusCode(rest) <> 200
        Debug CkRest::ckResponseStatusText(rest)
        Debug jsonResponse
        Debug "Failed."
        CkFileAccess::ckDispose(fac)
        CkRest::ckDispose(rest)
        CkAuthGoogle::ckDispose(authGoogle)
        CkJsonObject::ckDispose(pigRecord)
        ProcedureReturn
    EndIf

    ; Get the push ID generated by Firebase
    resp.i = CkJsonObject::ckCreate()
    If resp.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkJsonObject::ckLoad(resp,jsonResponse)
    pushId.s = CkJsonObject::ckStringOf(resp,"name")
    Debug "Added record with push ID " + pushId
    Debug "Success."


    CkFileAccess::ckDispose(fac)
    CkRest::ckDispose(rest)
    CkAuthGoogle::ckDispose(authGoogle)
    CkJsonObject::ckDispose(pigRecord)
    CkJsonObject::ckDispose(resp)


    ProcedureReturn
EndProcedure