Sample code for 30+ languages & platforms
Unicode C Requires Chilkat v11.0.0+

Clickatell One API: Read the account balance and currency

See more Clickatell Examples

Request the messaging balance associated with a One API integration key. The response supplies both the decimal amount and its currency. Read the amount as text for display to preserve its precision. A zero balance is a valid result. For example, a billing dashboard can display 1267.92865 ZAR.

Clickatell API reference

Chilkat Unicode C Downloads

Unicode C
#include <C_CkHttpW.h>
#include <C_CkHttpResponseW.h>
#include <C_CkJsonObjectW.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkHttpW http;
    HCkHttpResponseW resp;
    HCkJsonObjectW reply;
    BOOL parsed;

    success = FALSE;

    //  Assumes Chilkat is unlocked. See Global Unlock Sample.
    http = CkHttpW_Create();
    CkHttpW_putRequireSslCertVerify(http,TRUE);
    //  Supply the key for this One API integration from application configuration.
    CkHttpW_SetRequestHeader(http,L"Authorization",L"ONE_API_KEY");
    CkHttpW_SetRequestHeader(http,L"Accept",L"application/json");

    resp = CkHttpResponseW_Create();
    success = CkHttpW_HttpNoBody(http,L"GET",L"https://platform.clickatell.com/v1/balance",resp);
    if (CkHttpResponseW_getStatusCode(resp) == 0) {
        wprintf(L"No HTTP response. Check the connection and retry the lookup.\n");
        CkHttpW_Dispose(http);
        CkHttpResponseW_Dispose(resp);
        return;
    }

    reply = CkJsonObjectW_Create();
    parsed = CkJsonObjectW_Load(reply,CkHttpResponseW_bodyStr(resp));
    if ((success != TRUE) || ((CkHttpResponseW_getStatusCode(resp) != 200))) {
        wprintf(L"Clickatell returned HTTP %d\n",CkHttpResponseW_getStatusCode(resp));
        if (parsed == TRUE) {
            if (CkJsonObjectW_HasMember(reply,L"error.description") == TRUE) {
                wprintf(L"%s\n",CkJsonObjectW_stringOf(reply,L"error.description"));
            }

        }

        CkHttpW_Dispose(http);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(reply);
        return;
    }

    if (parsed != TRUE) {
        wprintf(L"Expected a JSON response.\n");
        CkHttpW_Dispose(http);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(reply);
        return;
    }

    //  JsonTypeOf returns 2 for a number and 1 for a string. Zero is a valid amount.
    if ((CkJsonObjectW_JsonTypeOf(reply,L"balance") != 2) || (CkJsonObjectW_JsonTypeOf(reply,L"currency") != 1)) {
        wprintf(L"The balance response is missing the amount or currency.\n");
        CkHttpW_Dispose(http);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(reply);
        return;
    }

    wprintf(L"Account balance: %s %s\n",CkJsonObjectW_stringOf(reply,L"balance"),CkJsonObjectW_stringOf(reply,L"currency"));


    CkHttpW_Dispose(http);
    CkHttpResponseW_Dispose(resp);
    CkJsonObjectW_Dispose(reply);

    }