Authentication

## Authentication Authentication — Authentication of web service requests |

## Synopsis

    char*               flickcurl_auth_checkToken           (flickcurl *fc,
                                                             const char *token);
    char*               flickcurl_auth_getFrob              (flickcurl *fc);
    char*               flickcurl_auth_getFullToken         (flickcurl *fc,
                                                             const char *frob);
    char*               flickcurl_auth_getToken             (flickcurl *fc,
                                                             const char *frob);

## Description

Authentication of web service requests

## Details

### flickcurl_auth_checkToken ()

    char*               flickcurl_auth_checkToken           (flickcurl *fc,
                                                             const char *token);

Get the credentials attached to an authentication token.

Implements flickr.auth.checkToken (0.9) Must be signed.

FIXME: Cannot confirm this works, get intermittent results.

`fc` : | flickcurl context
`token` : | token string
Returns : | permissions string or NULL on failure

### flickcurl_auth_getFrob ()

    char*               flickcurl_auth_getFrob              (flickcurl *fc);

Get a frob to be used during authentication

Implements flickr.auth.getFrob (0.9) Must be signed. Does not require authentication.

`fc` : | flickcurl context
Returns : | frob string or NULL on failure

### flickcurl_auth_getFullToken ()

    char*               flickcurl_auth_getFullToken         (flickcurl *fc,
                                                             const char *frob);

Turn a frob into an auth_token

Implements flickr.auth.getFullToken (0.5) Must be signed.

`fc` : | flickcurl context
`frob` : | frob string
Returns : | token string or NULL on failure

### flickcurl_auth_getToken ()

    char*               flickcurl_auth_getToken             (flickcurl *fc,
                                                             const char *frob);

Get the auth token for the given frob, if one has been attached.

Implements flickr.auth.getToken (0.9) Must be signed.

`fc` : | flickcurl context
`frob` : | frob string
Returns : | token string or NULL on failure