* * This source file is subject to the MIT license that is bundled * with this source code in the file LICENSE. */ namespace EasyWeChat\OfficialAccount\POI; use EasyWeChat\Kernel\BaseClient; /** * Class Client. * * @author overtrue */ class Client extends BaseClient { /** * Get POI supported categories. * * @return \Psr\Http\Message\ResponseInterface|\EasyWeChat\Kernel\Support\Collection|array|object|string * * @throws \EasyWeChat\Kernel\Exceptions\InvalidConfigException */ public function categories() { return $this->httpGet('cgi-bin/poi/getwxcategory'); } /** * Get POI by ID. * * @return \Psr\Http\Message\ResponseInterface|\EasyWeChat\Kernel\Support\Collection|array|object|string * * @throws \EasyWeChat\Kernel\Exceptions\InvalidConfigException * @throws \GuzzleHttp\Exception\GuzzleException */ public function get(int $poiId) { return $this->httpPostJson('cgi-bin/poi/getpoi', ['poi_id' => $poiId]); } /** * List POI. * * @return \Psr\Http\Message\ResponseInterface|\EasyWeChat\Kernel\Support\Collection|array|object|string * * @throws \EasyWeChat\Kernel\Exceptions\InvalidConfigException * @throws \GuzzleHttp\Exception\GuzzleException */ public function list(int $offset = 0, int $limit = 10) { $params = [ 'begin' => $offset, 'limit' => $limit, ]; return $this->httpPostJson('cgi-bin/poi/getpoilist', $params); } /** * Create a POI. * * @return \Psr\Http\Message\ResponseInterface|\EasyWeChat\Kernel\Support\Collection|array|object|string * * @throws \EasyWeChat\Kernel\Exceptions\InvalidConfigException * @throws \GuzzleHttp\Exception\GuzzleException */ public function create(array $baseInfo) { $params = [ 'business' => [ 'base_info' => $baseInfo, ], ]; return $this->httpPostJson('cgi-bin/poi/addpoi', $params); } /** * @return int * * @throws \EasyWeChat\Kernel\Exceptions\InvalidConfigException * @throws \GuzzleHttp\Exception\GuzzleException * @throws \EasyWeChat\Kernel\Exceptions\InvalidArgumentException */ public function createAndGetId(array $databaseInfo) { /** @var array $response */ $response = $this->detectAndCastResponseToType($this->create($databaseInfo), 'array'); return $response['poi_id']; } /** * Update a POI. * * @return \Psr\Http\Message\ResponseInterface|\EasyWeChat\Kernel\Support\Collection|array|object|string * * @throws \EasyWeChat\Kernel\Exceptions\InvalidConfigException * @throws \GuzzleHttp\Exception\GuzzleException */ public function update(int $poiId, array $baseInfo) { $params = [ 'business' => [ 'base_info' => array_merge($baseInfo, ['poi_id' => $poiId]), ], ]; return $this->httpPostJson('cgi-bin/poi/updatepoi', $params); } /** * Delete a POI. * * @return \Psr\Http\Message\ResponseInterface|\EasyWeChat\Kernel\Support\Collection|array|object|string * * @throws \EasyWeChat\Kernel\Exceptions\InvalidConfigException * @throws \GuzzleHttp\Exception\GuzzleException */ public function delete(int $poiId) { return $this->httpPostJson('cgi-bin/poi/delpoi', ['poi_id' => $poiId]); } }