plugins_api()

function plugins_api( $action, $args = array() ) {
	// Include an unmodified $gc_version.
	require ABSPATH . GCINC . '/version.php';

	if ( is_array( $args ) ) {
		$args = (object) $args;
	}

	if ( 'query_plugins' === $action ) {
		if ( ! isset( $args->per_page ) ) {
			$args->per_page = 24;
		}
	}

	if ( ! isset( $args->locale ) ) {
		$args->locale = get_user_locale();
	}

	if ( ! isset( $args->gc_version ) ) {
		$args->gc_version = substr( $gc_version, 0, 3 ); // x.y
	}

	/**
	 * Filters the GeChiUI.org Plugin Installation API arguments.
	 *
	 * Important: An object MUST be returned to this filter.
	 *
	 * @since 2.7.0
	 *
	 * @param object $args   Plugin API arguments.
	 * @param string $action The type of information being requested from the Plugin Installation API.
	 */
	$args = apply_filters( 'plugins_api_args', $args, $action );

	/**
	 * Filters the response for the current GeChiUI.org Plugin Installation API request.
	 *
	 * Passing a non-false value will effectively short-circuit the GeChiUI.org API request.
	 *
	 * If `$action` is 'query_plugins' or 'plugin_information', an object MUST be passed.
	 * If `$action` is 'hot_tags' or 'hot_categories', an array should be passed.
	 *
	 * @since 2.7.0
	 *
	 * @param false|object|array $result The result object or array. Default false.
	 * @param string             $action The type of information being requested from the Plugin Installation API.
	 * @param object             $args   Plugin API arguments.
	 */
	$res = apply_filters( 'plugins_api', false, $action, $args );

	if ( false === $res ) {

		$url = 'http://api.gechiui.org/plugins/info/1.2/';
		$url = add_query_arg(
			array(
				'action'  => $action,
				'request' => $args,
			),
			$url
		);

		$http_url = $url;
		$ssl      = gc_http_supports( array( 'ssl' ) );
		if ( $ssl ) {
			$url = set_url_scheme( $url, 'https' );
		}

		$http_args = array(
			'timeout'    => 15,
			'user-agent' => 'GeChiUI/' . $gc_version . '; ' . home_url( '/' ),
		);
		$request   = gc_remote_get( $url, $http_args );

		if ( $ssl && is_gc_error( $request ) ) {
			if ( ! gc_is_json_request() ) {
				trigger_error(
					sprintf(
						/* translators: %s: Support forums URL. */
						__( 'An unexpected error occurred. Something may be wrong with GeChiUI.org or this server&#8217;s configuration. If you continue to have problems, please try the <a href="https://docs.gechiui.com/functions/plugins_api/%s">support forums</a>.' ),
						__( 'https://gechiui.org/support/forums/' )
					) . ' ' . __( '(GeChiUI could not establish a secure connection to GeChiUI.org. Please contact your server administrator.)' ),
					headers_sent() || GC_DEBUG ? E_USER_WARNING : E_USER_NOTICE
				);
			}

			$request = gc_remote_get( $http_url, $http_args );
		}

		if ( is_gc_error( $request ) ) {
			$res = new GC_Error(
				'plugins_api_failed',
				sprintf(
					/* translators: %s: Support forums URL. */
					__( 'An unexpected error occurred. Something may be wrong with GeChiUI.org or this server&#8217;s configuration. If you continue to have problems, please try the <a href="https://docs.gechiui.com/functions/plugins_api/%s">support forums</a>.' ),
					__( 'https://gechiui.org/support/forums/' )
				),
				$request->get_error_message()
			);
		} else {
			$res = json_decode( gc_remote_retrieve_body( $request ), true );
			if ( is_array( $res ) ) {
				// Object casting is required in order to match the info/1.0 format.
				$res = (object) $res;
			} elseif ( null === $res ) {
				$res = new GC_Error(
					'plugins_api_failed',
					sprintf(
						/* translators: %s: Support forums URL. */
						__( 'An unexpected error occurred. Something may be wrong with GeChiUI.org or this server&#8217;s configuration. If you continue to have problems, please try the <a href="https://docs.gechiui.com/functions/plugins_api/%s">support forums</a>.' ),
						__( 'https://gechiui.org/support/forums/' )
					),
					gc_remote_retrieve_body( $request )
				);
			}

			if ( isset( $res->error ) ) {
				$res = new GC_Error( 'plugins_api_failed', $res->error );
			}
		}
	} elseif ( ! is_gc_error( $res ) ) {
		$res->external = true;
	}

	/**
	 * Filters the Plugin Installation API response results.
	 *
	 * @since 2.7.0
	 *
	 * @param object|GC_Error $res    Response object or GC_Error.
	 * @param string          $action The type of information being requested from the Plugin Installation API.
	 * @param object          $args   Plugin API arguments.
	 */
	return apply_filters( 'plugins_api_result', $res, $action, $args );
}

$fields = array(
	'active_installs' => true,           // rounded int
	'added' => true,                     // date
	'author' => true,                    // a href html
	'author_block_count' => true,        // int
	'author_block_rating' => true,       // int
	'author_profile' => true,            // url
	'banners' => true,                   // array( [low], [high] )
	'compatibility' => false,            // empty array?
	'contributors' => true,              // array( array( [profile], [avatar], [display_name] )
	'description' => false,              // string
	'donate_link' => true,               // url
	'download_link' => true,             // url
	'downloaded' => false,               // int
	// 'group' => false,                 // n/a 
	'homepage' => true,                  // url
	'icons' => false,                    // array( [1x] url, [2x] url )
	'last_updated' => true,              // datetime
	'name' => true,                      // string
	'num_ratings' => true,               // int
	'rating' => true,                    // int
	'ratings' => true,                   // array( [5..0] )
	'requires' => true,                  // version string
	'requires_php' => true,              // version string
	// 'reviews' => false,               // n/a, part of 'sections'
	'screenshots' => true,               // array( array( [src],  ) )
	'sections' => true,                  // array( [description], [installation], [changelog], [reviews], ...)
	'short_description' => false,        // string
	'slug' => true,                      // string
	'support_threads' => true,           // int
	'support_threads_resolved' => true,  // int
	'tags' => true,                      // array( )
	'tested' => true,                    // version string
	'version' => true,                   // version string
	'versions' => true,                  // array( [version] url )
);