Cookie Retrieval

Find cookies matching requests. More...

Functions
cookie_match_t *	cookie_jar_get_cookies_for_url (cookie_jar_t *jar, const char *url, bool include_http_only)
	Get cookies that match a URL.
cookie_match_t *	cookie_jar_get_cookies (cookie_jar_t *jar, const char *domain, const char *path, bool secure_only, bool include_http_only)
	Get cookies matching domain and path.
void	cookie_match_free (cookie_match_t *matches)
	Free a list of cookie matches.
char *	cookie_match_to_header (const cookie_match_t *matches)
	Convert cookie matches to HTTP Cookie header.

Detailed Description

Find cookies matching requests.

Function Documentation

cookie_jar_get_cookies()

cookie_match_t * cookie_jar_get_cookies	(	cookie_jar_t *	jar,
		const char *	domain,
		const char *	path,
		bool	secure_only,
		bool	include_http_only )

Get cookies matching domain and path.

Parameters

jar	Cookie jar
domain	Request domain
path	Request path
secure_only	Only include cookies that work over HTTPS
include_http_only	Include HttpOnly cookies

Returns

Linked list of matching cookies

cookie_jar_get_cookies_for_url()

cookie_match_t * cookie_jar_get_cookies_for_url	(	cookie_jar_t *	jar,
		const char *	url,
		bool	include_http_only )

Get cookies that match a URL.

Parameters

jar	Cookie jar
url	Request URL
include_http_only	Include HttpOnly cookies

Returns

Linked list of matching cookies (caller must free with cookie_match_free)

cookie_match_t *matches = cookie_jar_get_cookies_for_url(jar,
    "https://example.com/api", true);
 
char *header = cookie_match_to_header(matches);
if (header) {
    printf("Cookie: %s\n", header);
    free(header);
}
cookie_match_free(matches);

cookie_match_free()

void cookie_match_free

(

cookie_match_t *

matches

)

Free a list of cookie matches.

Parameters

matches

Cookie match list to free

cookie_match_to_header()

char * cookie_match_to_header

(

const cookie_match_t *

matches

)

Convert cookie matches to HTTP Cookie header.

Parameters

matches

Cookie match list

Returns

Cookie header string (caller must free), or NULL if no matches

cookie_match_t *matches = cookie_jar_get_cookies_for_url(jar, url, false);
char *cookie_header = cookie_match_to_header(matches);
if (cookie_header) {
    // Add to HTTP request: "Cookie: sessionid=abc123; csrf=xyz789"
    free(cookie_header);
}
cookie_match_free(matches);