C

HTTP HEAD Request

See more HTTP Examples

Sends an HTTP HEAD request and gets the response.

Note: The response to an HTTP HEAD request is always just the response header. The reponse body is always 0 length (thus the reason it's called a "HEAD" request..)

C

#include <C_CkHttp.h>
#include <C_CkHttpResponse.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkHttp http;
    HCkHttpResponse resp;
    int numHeaderFields;
    int i;

    success = FALSE;

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

    http = CkHttp_Create();

    // If the URL uses "https://", then the connection will be TLS.
    // Otherwise it will be TCP.

    // A failure is when we don't get any response.  It could be a timeout, an inability to connect, etc.
    // For example, a "404 Not Found" response is still a response, and thus deemed success in terms of the API..

    resp = CkHttpResponse_Create();
    success = CkHttp_HttpNoBody(http,"HEAD","https://example-code.com/",resp);
    if (success == FALSE) {
        printf("%s\n",CkHttp_lastErrorText(http));
        CkHttp_Dispose(http);
        CkHttpResponse_Dispose(resp);
        return;
    }

    // Examine the response.
    printf("Status Code = %d\n",CkHttpResponse_getStatusCode(resp));
    printf("Status Line = %s\n",CkHttpResponse_statusLine(resp));
    printf("Status Text = %s\n",CkHttpResponse_statusText(resp));
    printf("Full Response Header:\n");
    printf("%s\n",CkHttpResponse_header(resp));
    printf("----\n");
    numHeaderFields = CkHttpResponse_getNumHeaderFields(resp);
    printf("Num Header Fields: %d\n",numHeaderFields);

    for (i = 0; i <= numHeaderFields - 1; i++) {
        printf("%s: %s\n",CkHttpResponse_getHeaderName(resp,i),CkHttpResponse_getHeaderValue(resp,i));
    }



    CkHttp_Dispose(http);
    CkHttpResponse_Dispose(resp);

    }