http_layer_queries.h

00001 // Copyright (c) 2003-2013, LogMeIn, Inc. All rights reserved.
00002 // This is part of Xively C library, it is under the BSD 3-Clause license.
00003 
00004 /**
00005  * \file    http_layer_queries.c
00006  * \author  Olgierd Humenczuk
00007  * \brief   Helpers for making HTTP requests (specific to Xively REST/HTTP API)
00008  *
00009  *    * All functions return pointer to the buffer with request string or null in case of any error.
00010 
00011  * \warning The buffer is managed by the library, so it's forbidden to free the pointer.
00012  */
00013 
00014 #ifndef __HTTP_LAYERS_QUERIES_H__
00015 #define __HTTP_LAYERS_QUERIES_H__
00016 
00017 #include <stdlib.h>
00018 #include <stdint.h>
00019 
00020 #ifdef __cplusplus
00021 extern "C" {
00022 #endif
00023 
00024 const char* http_construct_request_datapoint(
00025           const char* http_method
00026         , const int32_t* feed_id
00027         , const char* datastream_id
00028         , const char* dp_ts_str
00029         , const char* x_api_key );
00030 
00031 const char* http_construct_request_datastream(
00032           const char* http_method
00033         , const int32_t* feed_id
00034         , const char* datastream_id
00035         , const char* x_api_key );
00036 
00037 const char* http_construct_request_feed(
00038           const char* http_method
00039         , const int32_t* feed_id
00040         , const char* x_api_key
00041         , const char* query_suffix );
00042 
00043 const char* http_construct_content(
00044           int32_t content_size );
00045 
00046 #ifdef __cplusplus
00047 }
00048 #endif
00049 
00050 #endif // __HTTP_LAYERS_QUERIES_H__