X-Git-Url: http://git.indexdata.com/?p=yaz-moved-to-github.git;a=blobdiff_plain;f=include%2Fyaz%2Furl.h;h=66edc5e56f8bf5c5ad38105f410a115a1bd4f388;hp=e1653660ab25ccfe385ca6e065c710ee74faef8f;hb=beab89a43b1060eff01824c32298128ef83a816e;hpb=77c5a4fca8b516fd39b8ba213daed17a465a6b2a diff --git a/include/yaz/url.h b/include/yaz/url.h index e165366..66edc5e 100644 --- a/include/yaz/url.h +++ b/include/yaz/url.h @@ -1,5 +1,5 @@ /* This file is part of the YAZ toolkit. - * Copyright (C) 1995-2012 Index Data. + * Copyright (C) 1995-2013 Index Data. * All rights reserved. * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: @@ -47,7 +47,7 @@ YAZ_EXPORT yaz_url_t yaz_url_create(void); /** \brief destroys a URL fetcher \param p handle - + Note: OK to pass NULL as p */ YAZ_EXPORT void yaz_url_destroy(yaz_url_t p); @@ -60,6 +60,12 @@ YAZ_EXPORT void yaz_url_destroy(yaz_url_t p); */ YAZ_EXPORT void yaz_url_set_proxy(yaz_url_t p, const char *proxy); +/** \brief sets maximum number of redirects + \param p handle + \param num maximum number of redirects +*/ +YAZ_EXPORT void yaz_url_set_max_redirects(yaz_url_t p, int num); + /** \brief executes the actual HTTP request (including redirects, etc) \param p handle \param uri URL @@ -68,11 +74,20 @@ YAZ_EXPORT void yaz_url_set_proxy(yaz_url_t p, const char *proxy); \param buf content buffer for HTTP request, NULL for empty content \param len content length for HTTP request \returns HTTP response; NULL on ERROR. + + Use yaz_url_get_error to get details if NULL is returned. */ YAZ_EXPORT Z_HTTP_Response *yaz_url_exec(yaz_url_t p, const char *uri, const char *method, Z_HTTP_Header *headers, const char *buf, size_t len); + +/** \brief get last error from yaz_url_exec + \param p handle + \returns message (possibly empty string no error occurred) +*/ +YAZ_EXPORT const char *yaz_url_get_error(yaz_url_t p); + YAZ_END_CDECL #endif