/**
* @brief The structure type for OAuth 2.0 Error handle.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
*/
typedef struct oauth2_error_s *oauth2_error_h;
/**
* @brief Gets error code.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
*
* @remarks You must not release @a server_error_code and @a platform_error_code using free().
* @param[in] handle The error handle
/**
* @brief Gets error description.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
*
* @remarks You must not release @a description using free().
* @param[in] handle The error handle
/**
* @brief Gets error uri.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
*
* @remarks You must not release @a uri using free().
* @param[in] handle The error handle
/**
* @brief Gets the custom data.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
*
* @remarks You must not release @a custom_value using free().
* @param[in] handle The error handle
/**
* @brief The structure type for OAuth 2.0 Manager handle.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
*/
typedef struct oauth2_manager_s *oauth2_manager_h;
/**
* @brief Creates #oauth2_manager_h handle.
* @remarks The @a handle must be released using oauth2_manager_destroy().
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
*
* @param[out] handle The created handle
* @return @c 0 on success,
/**
* @brief Destroys #oauth2_manager_h handle.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
*
* @param[in] handle The oauth2 manager handle
*
/**
* @brief Called when the oauth2_manager_request_token() response comes.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
* @remarks The @a response must be released using oauth2_response_destroy().
*
* @param[in] response The response
/**
* @brief Request OAuth 2.0 access token.
* @details The response is delivered via oauth2_token_cb().
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
* @privlevel public
* @privilege %http://tizen.org/privilege/internet
* @remarks The "internet" privilege is required to call this API. Note, only one pending request is allowed.
/**
* @brief Called when oauth2_manager_request_authorization_grant() response comes.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
*
* @param[in] response The response. The @a response must be released using oauth2_response_destroy().
* @param[in] user_data The user data passed from the callback function.
/**
* @brief Request authorization grant.
* @details The response is delivered via oauth2_auth_grant_cb().
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
* @privlevel public
* @privilege %http://tizen.org/privilege/internet
* @remarks The "internet" privilege is required to call this API. Note, only one pending request is allowed at a time.
/**
* @brief Called when oauth2_manager_request_access_token() response comes.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
*
* @param[in] response The response. The response must be released using oauth2_response_destroy().
* @param[in] user_data The user data passed from the callback function.
/**
* @brief Requests an access token.
* @details The response is delivered via oauth2_access_token_cb() callback.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
* @privlevel public
* @privilege %http://tizen.org/privilege/internet
* @remarks The "internet" privilege is required to call this API. Note, only one pending request is allowed at a time.
/**
* @brief Called when oauth2_manager_refresh_access_token() response comes.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
*
* @param[in] response The response. The @a response must be released using oauth2_response_destroy().
* @param[in] user_data The user data passed from the callback function.
/**
* @brief Requests a refresh token.
* @details The response is delivered via oauth2_refresh_token_cb() callback.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
* @privlevel public
* @privilege %http://tizen.org/privilege/internet
* @remarks The "internet" privilege is required to call this API. Note, only one pending request is allowed at a time.
/**
* @brief Returns whether oauth2_manager related request is pending.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
*
* @param[in] handle The auth2 manager handle.
* @retval false No pending request
/**
* @brief Clears the cookies.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
* @privlevel public
* @privilege %http://tizen.org/privilege/internet
*
/**
* @brief Clears the cache.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
* @privlevel public
* @privilege %http://tizen.org/privilege/internet
*
/**
* @brief The structure type for OAuth 2.0 Request handle.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ *@since_tizen 2.4
*/
typedef struct oauth2_request_s *oauth2_request_h;
/**
* @brief Creates #oauth2_request_h handle.
* @details The handle must be freed via oauth2_request_destroy().
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ *@since_tizen 2.4
*
* @param[out] handle The created oauth2_request handle, else NULL for error cases
*
/**
* @brief Destroys #oauth2_request_h handle.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ *@since_tizen 2.4
*
* @param[in] handle The oauth2_request handle to destroy
*
/**
* @brief Sets authorization end point URL.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ *@since_tizen 2.4
*
* @param[in] handle The request handle
* @param[in] url The url
/**
* @brief Sets access token end point URL.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ *@since_tizen 2.4
*
* @param[in] handle The request handle
* @param[in] url The url
/**
* @brief Sets redirection URL.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ *@since_tizen 2.4
*
* @param[in] handle The request handle
* @param[in] url The url
/**
* @brief Sets refresh token end point URL.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ *@since_tizen 2.4
*
* @param[in] handle The request handle
* @param[in] url The url
/**
* @brief Sets refresh token. Used mostly while using oauth2_manager_refresh_access_token().
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ *@since_tizen 2.4
*
* @param[in] handle The request handle
* @param[in] refresh_token The refresh token string
/**
* @brief Sets response type.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ *@since_tizen 2.4
*
* @param[in] handle The request handle
* @param[in] response_type The response type
/**
* @brief Sets client id.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ *@since_tizen 2.4
*
* @param[in] handle The request handle
* @param[in] client_id The client id
/**
* @brief Sets client secret.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ *@since_tizen 2.4
*
* @param[in] handle The request handle
* @param[in] client_secret The secret
/**
* @brief Sets client authentication type. Default is OAUTH2_CLIENT_AUTHENTICATION_TYPE_BASIC.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ *@since_tizen 2.4
*
* @remarks Facebook and Google does not support HTTP Basic Authentication, instead they require client credentials to be sent via request body.\n
* So application must set #OAUTH2_CLIENT_AUTHENTICATION_TYPE_REQUEST_BODY for them.
/**
* @brief Sets scope.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ *@since_tizen 2.4
*
* @param[in] handle The request handle
* @param[in] scope The scope
/**
* @brief Sets state.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ *@since_tizen 2.4
*
* @param[in] handle The request handle
* @param[in] state The state
/**
* @brief Sets grant type.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ *@since_tizen 2.4
*
* @param[in] handle The request handle
* @param[in] grant_type The grant type
/**
* @brief Sets authorization code.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ *@since_tizen 2.4
*
* @param[in] handle The request handle
* @param[in] code The authorization code
/**
* @brief Sets user name.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ *@since_tizen 2.4
*
* @param[in] handle The request handle
* @param[in] user_name The user name
/**
* @brief Sets password.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ *@since_tizen 2.4
*
* @param[in] handle The request handle
* @param[in] password The password
/**
* @brief Adds custom key-value pair to the request.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ *@since_tizen 2.4
*
* @param[in] handle The request handle
* @param[in] key The key
/**
* @brief Gets authorization end point URL.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ *@since_tizen 2.4
*
* @remarks You must not release @a url using free().
* @param[in] handle The request handle
/**
* @brief Gets access token end point URL.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ *@since_tizen 2.4
*
* @remarks You must not release @a url using free().
* @param[in] handle The request handle
/**
* @brief Gets redirection URL.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ *@since_tizen 2.4
*
* @remarks You must not release @a url using free().
* @param[in] handle The request handle
/**
* @brief Gets refresh token end point URL.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ *@since_tizen 2.4
*
* @remarks You must not release @a url using free().
* @param[in] handle The request handle
/**
* @brief Gets refresh token.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ *@since_tizen 2.4
*
* @remarks You must not release @a refresh_token using free().
* @param[in] handle The request handle
/**
* @brief Gets response type.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ *@since_tizen 2.4
*
* @remarks You must not free response_type
* @param[in] handle The request handle
/**
* @brief Gets client id.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ *@since_tizen 2.4
*
* @remarks You must not release @a client_id using free().
* @param[in] handle The request handle
/**
* @brief Gets client secret.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ *@since_tizen 2.4
*
* @remarks You must not release @a client_secret using free().
* @param[in] handle The request handle
/**
* @brief Gets scope.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ *@since_tizen 2.4
*
* @remarks You must not release @a scope using free().
* @param[in] handle The request handle
/**
* @brief Gets state.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ *@since_tizen 2.4
*
* @remarks You must not release @a state using free().
* @param[in] handle The request handle
/**
* @brief Gets grant type.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ *@since_tizen 2.4
*
* @remarks You must not release @a grant_type using free().
* @param[in] handle The request handle
/**
* @brief Gets authorization code.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ *@since_tizen 2.4
*
* @remarks You must not release @a code using free().
* @param[in] handle The request handle.
/**
* @brief Gets user name.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ *@since_tizen 2.4
*
* @remarks You must not release @a user_name using free().
* @param[in] handle The request handle
/**
* @brief Gets password.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ *@since_tizen 2.4
*
* @remarks You must not release @a password using free().
* @param[in] handle The request handle
/**
* @brief Gets the custom value.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ *@since_tizen 2.4
*
* @remarks You must not release @a custom_value using free().
* @param[in] handle The request handle
/**
* @brief The structure type for OAuth 2.0 Response handle.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
*/
typedef struct oauth2_response_s *oauth2_response_h;
/**
* @brief Destroys the received handle.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
*
* @param[in] handle The response handle
*
/**
* @brief Gets the authorization code.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
*
* @remarks You must not release @a code using free().
* @param[in] handle The response handle
/**
* @brief Gets state.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
*
* @remarks You must not release @a state using free().
* @param[in] handle The response handle
/**
* @brief Gets access token.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
*
* @remarks You must not release @a access_token using free().
* @param[in] handle The response handle
/**
* @brief Gets token type.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
*
* @remarks You must not release @a token_type using free().
* @param[in] handle The response handle
/**
* @brief Gets expiry time.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
*
* @remarks You must not release @a expires_in using free().
* @param[in] handle The response handle
/**
* @brief Gets refresh token.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
*
* @remarks You must not release @a refresh_token using free().
* @param[in] handle The response handle
/**
* @brief Gets scope.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
*
* @remarks You must not release @a scope using free().
* @param[in] handle The response handle
/**
* @brief Gets error.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
*
* @remarks You must not release @a error using free().
* @param[in] handle The response handle
/**
* @brief Gets the custom data.
* @details Some service providers send additional keys not specified in OAuth 2.0 RFC. To get those additional fields this API needs to be used.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
*
* @remarks You must not release @a custom_value using free().
* @param[in] handle The response handle
/**
* @brief Enumerations for Client authentication scheme, used to sign client id and client secret accordingly.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
* @remarks Facebook and Google does not support HTTP Basic Authentication, instead they require client credentials to be sent via request body.
* Default is #OAUTH2_CLIENT_AUTHENTICATION_TYPE_BASIC (<a href="http://tools.ietf.org/html/rfc2617#section-2">rfc2617#section-2</a>)
*
/**
* @brief Enumerations to set grant_type.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
*
* @see oauth2_request_set_grant_type()
*/
/**
* @brief Enumerations to set response_type.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
*
* @see oauth2_request_set_response_type()
*/
/**
* @brief Enumerations of error codes for oauth2 APIs.
- * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
+ * @since_tizen 2.4
*/
typedef enum {
OAUTH2_ERROR_NONE = TIZEN_ERROR_NONE, /**< Successful */