[ 'application/json', ], 'getApiV3Terms' => [ 'application/json', ], 'getApiV3TermsTerm' => [ 'application/json', ], 'patchApiV3TermsTerm' => [ 'application/json', ], ]; /** * @param ClientInterface $client * @param Configuration $config * @param HeaderSelector $selector * @param int $hostIndex (Optional) host index to select the list of hosts if defined in the OpenAPI spec */ public function __construct( ?ClientInterface $client = null, ?Configuration $config = null, ?HeaderSelector $selector = null, int $hostIndex = 0 ) { $this->client = $client ?: new Client(); $this->config = $config ?: Configuration::getDefaultConfiguration(); $this->headerSelector = $selector ?: new HeaderSelector(); $this->hostIndex = $hostIndex; } /** * Set the host index * * @param int $hostIndex Host index (required) */ public function setHostIndex($hostIndex): void { $this->hostIndex = $hostIndex; } /** * Get the host index * * @return int Host index */ public function getHostIndex() { return $this->hostIndex; } /** * @return Configuration */ public function getConfig() { return $this->config; } /** * Operation deleteApiV3TermsTerm * * 删术语 * * @param string $term 术语 id(guid) (required) * @param string $contentType The value for the Content-Type header. Check self::contentTypes['deleteApiV3TermsTerm'] to see the possible values for this operation * * @throws \WikipaliApi\ApiException on non-2xx response or if the response body is not in the expected format * @throws \InvalidArgumentException * @return \WikipaliApi\Model\PostApiV3ChannelsChannelTerms200Response|\WikipaliApi\Model\ProblemDetails|\WikipaliApi\Model\ProblemDetails|\WikipaliApi\Model\ProblemDetails */ public function deleteApiV3TermsTerm($term, string $contentType = self::contentTypes['deleteApiV3TermsTerm'][0]) { list($response) = $this->deleteApiV3TermsTermWithHttpInfo($term, $contentType); return $response; } /** * Operation deleteApiV3TermsTermWithHttpInfo * * 删术语 * * @param string $term 术语 id(guid) (required) * @param string $contentType The value for the Content-Type header. Check self::contentTypes['deleteApiV3TermsTerm'] to see the possible values for this operation * * @throws \WikipaliApi\ApiException on non-2xx response or if the response body is not in the expected format * @throws \InvalidArgumentException * @return array of \WikipaliApi\Model\PostApiV3ChannelsChannelTerms200Response|\WikipaliApi\Model\ProblemDetails|\WikipaliApi\Model\ProblemDetails|\WikipaliApi\Model\ProblemDetails, HTTP status code, HTTP response headers (array of strings) */ public function deleteApiV3TermsTermWithHttpInfo($term, string $contentType = self::contentTypes['deleteApiV3TermsTerm'][0]) { $request = $this->deleteApiV3TermsTermRequest($term, $contentType); try { $options = $this->createHttpClientOption(); try { $response = $this->client->send($request, $options); } catch (RequestException $e) { throw new ApiException( "[{$e->getCode()}] {$e->getMessage()}", (int) $e->getCode(), $e->getResponse() ? $e->getResponse()->getHeaders() : null, $e->getResponse() ? (string) $e->getResponse()->getBody() : null ); } catch (ConnectException $e) { throw new ApiException( "[{$e->getCode()}] {$e->getMessage()}", (int) $e->getCode(), null, null ); } $statusCode = $response->getStatusCode(); switch($statusCode) { case 200: return $this->handleResponseWithDataType( '\WikipaliApi\Model\PostApiV3ChannelsChannelTerms200Response', $request, $response, ); case 401: return $this->handleResponseWithDataType( '\WikipaliApi\Model\ProblemDetails', $request, $response, ); case 403: return $this->handleResponseWithDataType( '\WikipaliApi\Model\ProblemDetails', $request, $response, ); case 422: return $this->handleResponseWithDataType( '\WikipaliApi\Model\ProblemDetails', $request, $response, ); } if ($statusCode < 200 || $statusCode > 299) { throw new ApiException( sprintf( '[%d] Error connecting to the API (%s)', $statusCode, (string) $request->getUri() ), $statusCode, $response->getHeaders(), (string) $response->getBody() ); } return $this->handleResponseWithDataType( '\WikipaliApi\Model\PostApiV3ChannelsChannelTerms200Response', $request, $response, ); } catch (ApiException $e) { switch ($e->getCode()) { case 200: $data = ObjectSerializer::deserialize( $e->getResponseBody(), '\WikipaliApi\Model\PostApiV3ChannelsChannelTerms200Response', $e->getResponseHeaders() ); $e->setResponseObject($data); throw $e; case 401: $data = ObjectSerializer::deserialize( $e->getResponseBody(), '\WikipaliApi\Model\ProblemDetails', $e->getResponseHeaders() ); $e->setResponseObject($data); throw $e; case 403: $data = ObjectSerializer::deserialize( $e->getResponseBody(), '\WikipaliApi\Model\ProblemDetails', $e->getResponseHeaders() ); $e->setResponseObject($data); throw $e; case 422: $data = ObjectSerializer::deserialize( $e->getResponseBody(), '\WikipaliApi\Model\ProblemDetails', $e->getResponseHeaders() ); $e->setResponseObject($data); throw $e; } throw $e; } } /** * Operation deleteApiV3TermsTermAsync * * 删术语 * * @param string $term 术语 id(guid) (required) * @param string $contentType The value for the Content-Type header. Check self::contentTypes['deleteApiV3TermsTerm'] to see the possible values for this operation * * @throws \InvalidArgumentException * @return \GuzzleHttp\Promise\PromiseInterface */ public function deleteApiV3TermsTermAsync($term, string $contentType = self::contentTypes['deleteApiV3TermsTerm'][0]) { return $this->deleteApiV3TermsTermAsyncWithHttpInfo($term, $contentType) ->then( function ($response) { return $response[0]; } ); } /** * Operation deleteApiV3TermsTermAsyncWithHttpInfo * * 删术语 * * @param string $term 术语 id(guid) (required) * @param string $contentType The value for the Content-Type header. Check self::contentTypes['deleteApiV3TermsTerm'] to see the possible values for this operation * * @throws \InvalidArgumentException * @return \GuzzleHttp\Promise\PromiseInterface */ public function deleteApiV3TermsTermAsyncWithHttpInfo($term, string $contentType = self::contentTypes['deleteApiV3TermsTerm'][0]) { $returnType = '\WikipaliApi\Model\PostApiV3ChannelsChannelTerms200Response'; $request = $this->deleteApiV3TermsTermRequest($term, $contentType); return $this->client ->sendAsync($request, $this->createHttpClientOption()) ->then( function ($response) use ($returnType) { if ($returnType === '\SplFileObject') { $content = $response->getBody(); //stream goes to serializer } else { $content = (string) $response->getBody(); if ($returnType !== 'string') { $content = json_decode($content); } } return [ ObjectSerializer::deserialize($content, $returnType, []), $response->getStatusCode(), $response->getHeaders() ]; }, function ($exception) { $response = $exception->getResponse(); $statusCode = $response->getStatusCode(); throw new ApiException( sprintf( '[%d] Error connecting to the API (%s)', $statusCode, $exception->getRequest()->getUri() ), $statusCode, $response->getHeaders(), (string) $response->getBody() ); } ); } /** * Create request for operation 'deleteApiV3TermsTerm' * * @param string $term 术语 id(guid) (required) * @param string $contentType The value for the Content-Type header. Check self::contentTypes['deleteApiV3TermsTerm'] to see the possible values for this operation * * @throws \InvalidArgumentException * @return \GuzzleHttp\Psr7\Request */ public function deleteApiV3TermsTermRequest($term, string $contentType = self::contentTypes['deleteApiV3TermsTerm'][0]) { // verify the required parameter 'term' is set if ($term === null || (is_array($term) && count($term) === 0)) { throw new \InvalidArgumentException( 'Missing the required parameter $term when calling deleteApiV3TermsTerm' ); } $resourcePath = '/v3/terms/{term}'; $formParams = []; $queryParams = []; $headerParams = []; $httpBody = ''; $multipart = false; // path params if ($term !== null) { $resourcePath = str_replace( '{term}', ObjectSerializer::toPathValue($term), $resourcePath ); } $headers = $this->headerSelector->selectHeaders( ['application/json', 'application/problem+json', ], $contentType, $multipart ); // for model (json/xml) if (count($formParams) > 0) { if ($multipart) { $multipartContents = []; foreach ($formParams as $formParamName => $formParamValue) { $formParamValueItems = is_array($formParamValue) ? $formParamValue : [$formParamValue]; foreach ($formParamValueItems as $formParamValueItem) { $multipartContents[] = [ 'name' => $formParamName, 'contents' => $formParamValueItem ]; } } // for HTTP post (form) $httpBody = new MultipartStream($multipartContents); } elseif (stripos($headers['Content-Type'], 'application/json') !== false) { # if Content-Type contains "application/json", json_encode the form parameters try { $httpBody = json_encode($formParams, JSON_THROW_ON_ERROR); } catch (\JsonException $e) { throw new \InvalidArgumentException('json_encode error: ' . $e->getMessage(), 0, $e); } } else { // for HTTP post (form) $httpBody = ObjectSerializer::buildQuery($formParams); } } // this endpoint requires Bearer authentication (access token) if (!empty($this->config->getAccessToken())) { $headers['Authorization'] = 'Bearer ' . $this->config->getAccessToken(); } $defaultHeaders = []; if ($this->config->getUserAgent()) { $defaultHeaders['User-Agent'] = $this->config->getUserAgent(); } $headers = array_merge( $defaultHeaders, $headerParams, $headers ); $operationHost = $this->config->getHost(); $query = ObjectSerializer::buildQuery($queryParams); return new Request( 'DELETE', $operationHost . $resourcePath . ($query ? "?{$query}" : ''), $headers, $httpBody ); } /** * Operation getApiV3Terms * * 按词查术语 * * @param string $word 巴利词,逗号分隔,最多 50 个 (required) * @param bool|null $with_body 每条都带渲染后的正文 `body` (optional) * @param int|null $per_page 每页条数,最大 200 (optional, default to 20) * @param string|null $tag 义项;传空串只要没有义项的 (optional) * @param string|null $channel 只要这个 channel 的 (optional) * @param string|null $language 只要这个语言的 (optional) * @param int|null $page 页码 (optional) * @param string $contentType The value for the Content-Type header. Check self::contentTypes['getApiV3Terms'] to see the possible values for this operation * * @throws \WikipaliApi\ApiException on non-2xx response or if the response body is not in the expected format * @throws \InvalidArgumentException * @return \WikipaliApi\Model\GetApiV3ChannelsChannelTerms200Response|\WikipaliApi\Model\ProblemDetails */ public function getApiV3Terms($word, $with_body = null, $per_page = 20, $tag = null, $channel = null, $language = null, $page = null, string $contentType = self::contentTypes['getApiV3Terms'][0]) { list($response) = $this->getApiV3TermsWithHttpInfo($word, $with_body, $per_page, $tag, $channel, $language, $page, $contentType); return $response; } /** * Operation getApiV3TermsWithHttpInfo * * 按词查术语 * * @param string $word 巴利词,逗号分隔,最多 50 个 (required) * @param bool|null $with_body 每条都带渲染后的正文 `body` (optional) * @param int|null $per_page 每页条数,最大 200 (optional, default to 20) * @param string|null $tag 义项;传空串只要没有义项的 (optional) * @param string|null $channel 只要这个 channel 的 (optional) * @param string|null $language 只要这个语言的 (optional) * @param int|null $page 页码 (optional) * @param string $contentType The value for the Content-Type header. Check self::contentTypes['getApiV3Terms'] to see the possible values for this operation * * @throws \WikipaliApi\ApiException on non-2xx response or if the response body is not in the expected format * @throws \InvalidArgumentException * @return array of \WikipaliApi\Model\GetApiV3ChannelsChannelTerms200Response|\WikipaliApi\Model\ProblemDetails, HTTP status code, HTTP response headers (array of strings) */ public function getApiV3TermsWithHttpInfo($word, $with_body = null, $per_page = 20, $tag = null, $channel = null, $language = null, $page = null, string $contentType = self::contentTypes['getApiV3Terms'][0]) { $request = $this->getApiV3TermsRequest($word, $with_body, $per_page, $tag, $channel, $language, $page, $contentType); try { $options = $this->createHttpClientOption(); try { $response = $this->client->send($request, $options); } catch (RequestException $e) { throw new ApiException( "[{$e->getCode()}] {$e->getMessage()}", (int) $e->getCode(), $e->getResponse() ? $e->getResponse()->getHeaders() : null, $e->getResponse() ? (string) $e->getResponse()->getBody() : null ); } catch (ConnectException $e) { throw new ApiException( "[{$e->getCode()}] {$e->getMessage()}", (int) $e->getCode(), null, null ); } $statusCode = $response->getStatusCode(); switch($statusCode) { case 200: return $this->handleResponseWithDataType( '\WikipaliApi\Model\GetApiV3ChannelsChannelTerms200Response', $request, $response, ); case 422: return $this->handleResponseWithDataType( '\WikipaliApi\Model\ProblemDetails', $request, $response, ); } if ($statusCode < 200 || $statusCode > 299) { throw new ApiException( sprintf( '[%d] Error connecting to the API (%s)', $statusCode, (string) $request->getUri() ), $statusCode, $response->getHeaders(), (string) $response->getBody() ); } return $this->handleResponseWithDataType( '\WikipaliApi\Model\GetApiV3ChannelsChannelTerms200Response', $request, $response, ); } catch (ApiException $e) { switch ($e->getCode()) { case 200: $data = ObjectSerializer::deserialize( $e->getResponseBody(), '\WikipaliApi\Model\GetApiV3ChannelsChannelTerms200Response', $e->getResponseHeaders() ); $e->setResponseObject($data); throw $e; case 422: $data = ObjectSerializer::deserialize( $e->getResponseBody(), '\WikipaliApi\Model\ProblemDetails', $e->getResponseHeaders() ); $e->setResponseObject($data); throw $e; } throw $e; } } /** * Operation getApiV3TermsAsync * * 按词查术语 * * @param string $word 巴利词,逗号分隔,最多 50 个 (required) * @param bool|null $with_body 每条都带渲染后的正文 `body` (optional) * @param int|null $per_page 每页条数,最大 200 (optional, default to 20) * @param string|null $tag 义项;传空串只要没有义项的 (optional) * @param string|null $channel 只要这个 channel 的 (optional) * @param string|null $language 只要这个语言的 (optional) * @param int|null $page 页码 (optional) * @param string $contentType The value for the Content-Type header. Check self::contentTypes['getApiV3Terms'] to see the possible values for this operation * * @throws \InvalidArgumentException * @return \GuzzleHttp\Promise\PromiseInterface */ public function getApiV3TermsAsync($word, $with_body = null, $per_page = 20, $tag = null, $channel = null, $language = null, $page = null, string $contentType = self::contentTypes['getApiV3Terms'][0]) { return $this->getApiV3TermsAsyncWithHttpInfo($word, $with_body, $per_page, $tag, $channel, $language, $page, $contentType) ->then( function ($response) { return $response[0]; } ); } /** * Operation getApiV3TermsAsyncWithHttpInfo * * 按词查术语 * * @param string $word 巴利词,逗号分隔,最多 50 个 (required) * @param bool|null $with_body 每条都带渲染后的正文 `body` (optional) * @param int|null $per_page 每页条数,最大 200 (optional, default to 20) * @param string|null $tag 义项;传空串只要没有义项的 (optional) * @param string|null $channel 只要这个 channel 的 (optional) * @param string|null $language 只要这个语言的 (optional) * @param int|null $page 页码 (optional) * @param string $contentType The value for the Content-Type header. Check self::contentTypes['getApiV3Terms'] to see the possible values for this operation * * @throws \InvalidArgumentException * @return \GuzzleHttp\Promise\PromiseInterface */ public function getApiV3TermsAsyncWithHttpInfo($word, $with_body = null, $per_page = 20, $tag = null, $channel = null, $language = null, $page = null, string $contentType = self::contentTypes['getApiV3Terms'][0]) { $returnType = '\WikipaliApi\Model\GetApiV3ChannelsChannelTerms200Response'; $request = $this->getApiV3TermsRequest($word, $with_body, $per_page, $tag, $channel, $language, $page, $contentType); return $this->client ->sendAsync($request, $this->createHttpClientOption()) ->then( function ($response) use ($returnType) { if ($returnType === '\SplFileObject') { $content = $response->getBody(); //stream goes to serializer } else { $content = (string) $response->getBody(); if ($returnType !== 'string') { $content = json_decode($content); } } return [ ObjectSerializer::deserialize($content, $returnType, []), $response->getStatusCode(), $response->getHeaders() ]; }, function ($exception) { $response = $exception->getResponse(); $statusCode = $response->getStatusCode(); throw new ApiException( sprintf( '[%d] Error connecting to the API (%s)', $statusCode, $exception->getRequest()->getUri() ), $statusCode, $response->getHeaders(), (string) $response->getBody() ); } ); } /** * Create request for operation 'getApiV3Terms' * * @param string $word 巴利词,逗号分隔,最多 50 个 (required) * @param bool|null $with_body 每条都带渲染后的正文 `body` (optional) * @param int|null $per_page 每页条数,最大 200 (optional, default to 20) * @param string|null $tag 义项;传空串只要没有义项的 (optional) * @param string|null $channel 只要这个 channel 的 (optional) * @param string|null $language 只要这个语言的 (optional) * @param int|null $page 页码 (optional) * @param string $contentType The value for the Content-Type header. Check self::contentTypes['getApiV3Terms'] to see the possible values for this operation * * @throws \InvalidArgumentException * @return \GuzzleHttp\Psr7\Request */ public function getApiV3TermsRequest($word, $with_body = null, $per_page = 20, $tag = null, $channel = null, $language = null, $page = null, string $contentType = self::contentTypes['getApiV3Terms'][0]) { // verify the required parameter 'word' is set if ($word === null || (is_array($word) && count($word) === 0)) { throw new \InvalidArgumentException( 'Missing the required parameter $word when calling getApiV3Terms' ); } $resourcePath = '/v3/terms'; $formParams = []; $queryParams = []; $headerParams = []; $httpBody = ''; $multipart = false; // query params $queryParams = array_merge($queryParams, ObjectSerializer::toQueryValue( $with_body, 'with_body', // param base name 'boolean', // openApiType 'form', // style true, // explode false // required ) ?? []); // query params $queryParams = array_merge($queryParams, ObjectSerializer::toQueryValue( $per_page, 'per_page', // param base name 'integer', // openApiType 'form', // style true, // explode false // required ) ?? []); // query params $queryParams = array_merge($queryParams, ObjectSerializer::toQueryValue( $word, 'word', // param base name 'string', // openApiType 'form', // style true, // explode true // required ) ?? []); // query params $queryParams = array_merge($queryParams, ObjectSerializer::toQueryValue( $tag, 'tag', // param base name 'string', // openApiType 'form', // style true, // explode false // required ) ?? []); // query params $queryParams = array_merge($queryParams, ObjectSerializer::toQueryValue( $channel, 'channel', // param base name 'string', // openApiType 'form', // style true, // explode false // required ) ?? []); // query params $queryParams = array_merge($queryParams, ObjectSerializer::toQueryValue( $language, 'language', // param base name 'string', // openApiType 'form', // style true, // explode false // required ) ?? []); // query params $queryParams = array_merge($queryParams, ObjectSerializer::toQueryValue( $page, 'page', // param base name 'integer', // openApiType 'form', // style true, // explode false // required ) ?? []); $headers = $this->headerSelector->selectHeaders( ['application/json', 'application/problem+json', ], $contentType, $multipart ); // for model (json/xml) if (count($formParams) > 0) { if ($multipart) { $multipartContents = []; foreach ($formParams as $formParamName => $formParamValue) { $formParamValueItems = is_array($formParamValue) ? $formParamValue : [$formParamValue]; foreach ($formParamValueItems as $formParamValueItem) { $multipartContents[] = [ 'name' => $formParamName, 'contents' => $formParamValueItem ]; } } // for HTTP post (form) $httpBody = new MultipartStream($multipartContents); } elseif (stripos($headers['Content-Type'], 'application/json') !== false) { # if Content-Type contains "application/json", json_encode the form parameters try { $httpBody = json_encode($formParams, JSON_THROW_ON_ERROR); } catch (\JsonException $e) { throw new \InvalidArgumentException('json_encode error: ' . $e->getMessage(), 0, $e); } } else { // for HTTP post (form) $httpBody = ObjectSerializer::buildQuery($formParams); } } // this endpoint requires Bearer authentication (access token) if (!empty($this->config->getAccessToken())) { $headers['Authorization'] = 'Bearer ' . $this->config->getAccessToken(); } $defaultHeaders = []; if ($this->config->getUserAgent()) { $defaultHeaders['User-Agent'] = $this->config->getUserAgent(); } $headers = array_merge( $defaultHeaders, $headerParams, $headers ); $operationHost = $this->config->getHost(); $query = ObjectSerializer::buildQuery($queryParams); return new Request( 'GET', $operationHost . $resourcePath . ($query ? "?{$query}" : ''), $headers, $httpBody ); } /** * Operation getApiV3TermsTerm * * 术语详情 * * @param string $term 术语 id(guid) (required) * @param string|null $channels 正文按这些 channel 解析(句子、术语),逗号分隔,最多 20 个;只认你看得见的,不给就用术语所在 channel (optional) * @param string|null $mode 正文模式 (optional, default to 'read') * @param string|null $format 正文格式:tree 给节点树 `body`,html 给 HTML 字符串 `html`(WebView 显示用) (optional, default to 'tree') * @param string $contentType The value for the Content-Type header. Check self::contentTypes['getApiV3TermsTerm'] to see the possible values for this operation * * @throws \WikipaliApi\ApiException on non-2xx response or if the response body is not in the expected format * @throws \InvalidArgumentException * @return \WikipaliApi\Model\PostApiV3ChannelsChannelTerms200Response|\WikipaliApi\Model\ProblemDetails|\WikipaliApi\Model\ProblemDetails */ public function getApiV3TermsTerm($term, $channels = null, $mode = 'read', $format = 'tree', string $contentType = self::contentTypes['getApiV3TermsTerm'][0]) { list($response) = $this->getApiV3TermsTermWithHttpInfo($term, $channels, $mode, $format, $contentType); return $response; } /** * Operation getApiV3TermsTermWithHttpInfo * * 术语详情 * * @param string $term 术语 id(guid) (required) * @param string|null $channels 正文按这些 channel 解析(句子、术语),逗号分隔,最多 20 个;只认你看得见的,不给就用术语所在 channel (optional) * @param string|null $mode 正文模式 (optional, default to 'read') * @param string|null $format 正文格式:tree 给节点树 `body`,html 给 HTML 字符串 `html`(WebView 显示用) (optional, default to 'tree') * @param string $contentType The value for the Content-Type header. Check self::contentTypes['getApiV3TermsTerm'] to see the possible values for this operation * * @throws \WikipaliApi\ApiException on non-2xx response or if the response body is not in the expected format * @throws \InvalidArgumentException * @return array of \WikipaliApi\Model\PostApiV3ChannelsChannelTerms200Response|\WikipaliApi\Model\ProblemDetails|\WikipaliApi\Model\ProblemDetails, HTTP status code, HTTP response headers (array of strings) */ public function getApiV3TermsTermWithHttpInfo($term, $channels = null, $mode = 'read', $format = 'tree', string $contentType = self::contentTypes['getApiV3TermsTerm'][0]) { $request = $this->getApiV3TermsTermRequest($term, $channels, $mode, $format, $contentType); try { $options = $this->createHttpClientOption(); try { $response = $this->client->send($request, $options); } catch (RequestException $e) { throw new ApiException( "[{$e->getCode()}] {$e->getMessage()}", (int) $e->getCode(), $e->getResponse() ? $e->getResponse()->getHeaders() : null, $e->getResponse() ? (string) $e->getResponse()->getBody() : null ); } catch (ConnectException $e) { throw new ApiException( "[{$e->getCode()}] {$e->getMessage()}", (int) $e->getCode(), null, null ); } $statusCode = $response->getStatusCode(); switch($statusCode) { case 200: return $this->handleResponseWithDataType( '\WikipaliApi\Model\PostApiV3ChannelsChannelTerms200Response', $request, $response, ); case 403: return $this->handleResponseWithDataType( '\WikipaliApi\Model\ProblemDetails', $request, $response, ); case 422: return $this->handleResponseWithDataType( '\WikipaliApi\Model\ProblemDetails', $request, $response, ); } if ($statusCode < 200 || $statusCode > 299) { throw new ApiException( sprintf( '[%d] Error connecting to the API (%s)', $statusCode, (string) $request->getUri() ), $statusCode, $response->getHeaders(), (string) $response->getBody() ); } return $this->handleResponseWithDataType( '\WikipaliApi\Model\PostApiV3ChannelsChannelTerms200Response', $request, $response, ); } catch (ApiException $e) { switch ($e->getCode()) { case 200: $data = ObjectSerializer::deserialize( $e->getResponseBody(), '\WikipaliApi\Model\PostApiV3ChannelsChannelTerms200Response', $e->getResponseHeaders() ); $e->setResponseObject($data); throw $e; case 403: $data = ObjectSerializer::deserialize( $e->getResponseBody(), '\WikipaliApi\Model\ProblemDetails', $e->getResponseHeaders() ); $e->setResponseObject($data); throw $e; case 422: $data = ObjectSerializer::deserialize( $e->getResponseBody(), '\WikipaliApi\Model\ProblemDetails', $e->getResponseHeaders() ); $e->setResponseObject($data); throw $e; } throw $e; } } /** * Operation getApiV3TermsTermAsync * * 术语详情 * * @param string $term 术语 id(guid) (required) * @param string|null $channels 正文按这些 channel 解析(句子、术语),逗号分隔,最多 20 个;只认你看得见的,不给就用术语所在 channel (optional) * @param string|null $mode 正文模式 (optional, default to 'read') * @param string|null $format 正文格式:tree 给节点树 `body`,html 给 HTML 字符串 `html`(WebView 显示用) (optional, default to 'tree') * @param string $contentType The value for the Content-Type header. Check self::contentTypes['getApiV3TermsTerm'] to see the possible values for this operation * * @throws \InvalidArgumentException * @return \GuzzleHttp\Promise\PromiseInterface */ public function getApiV3TermsTermAsync($term, $channels = null, $mode = 'read', $format = 'tree', string $contentType = self::contentTypes['getApiV3TermsTerm'][0]) { return $this->getApiV3TermsTermAsyncWithHttpInfo($term, $channels, $mode, $format, $contentType) ->then( function ($response) { return $response[0]; } ); } /** * Operation getApiV3TermsTermAsyncWithHttpInfo * * 术语详情 * * @param string $term 术语 id(guid) (required) * @param string|null $channels 正文按这些 channel 解析(句子、术语),逗号分隔,最多 20 个;只认你看得见的,不给就用术语所在 channel (optional) * @param string|null $mode 正文模式 (optional, default to 'read') * @param string|null $format 正文格式:tree 给节点树 `body`,html 给 HTML 字符串 `html`(WebView 显示用) (optional, default to 'tree') * @param string $contentType The value for the Content-Type header. Check self::contentTypes['getApiV3TermsTerm'] to see the possible values for this operation * * @throws \InvalidArgumentException * @return \GuzzleHttp\Promise\PromiseInterface */ public function getApiV3TermsTermAsyncWithHttpInfo($term, $channels = null, $mode = 'read', $format = 'tree', string $contentType = self::contentTypes['getApiV3TermsTerm'][0]) { $returnType = '\WikipaliApi\Model\PostApiV3ChannelsChannelTerms200Response'; $request = $this->getApiV3TermsTermRequest($term, $channels, $mode, $format, $contentType); return $this->client ->sendAsync($request, $this->createHttpClientOption()) ->then( function ($response) use ($returnType) { if ($returnType === '\SplFileObject') { $content = $response->getBody(); //stream goes to serializer } else { $content = (string) $response->getBody(); if ($returnType !== 'string') { $content = json_decode($content); } } return [ ObjectSerializer::deserialize($content, $returnType, []), $response->getStatusCode(), $response->getHeaders() ]; }, function ($exception) { $response = $exception->getResponse(); $statusCode = $response->getStatusCode(); throw new ApiException( sprintf( '[%d] Error connecting to the API (%s)', $statusCode, $exception->getRequest()->getUri() ), $statusCode, $response->getHeaders(), (string) $response->getBody() ); } ); } /** * Create request for operation 'getApiV3TermsTerm' * * @param string $term 术语 id(guid) (required) * @param string|null $channels 正文按这些 channel 解析(句子、术语),逗号分隔,最多 20 个;只认你看得见的,不给就用术语所在 channel (optional) * @param string|null $mode 正文模式 (optional, default to 'read') * @param string|null $format 正文格式:tree 给节点树 `body`,html 给 HTML 字符串 `html`(WebView 显示用) (optional, default to 'tree') * @param string $contentType The value for the Content-Type header. Check self::contentTypes['getApiV3TermsTerm'] to see the possible values for this operation * * @throws \InvalidArgumentException * @return \GuzzleHttp\Psr7\Request */ public function getApiV3TermsTermRequest($term, $channels = null, $mode = 'read', $format = 'tree', string $contentType = self::contentTypes['getApiV3TermsTerm'][0]) { // verify the required parameter 'term' is set if ($term === null || (is_array($term) && count($term) === 0)) { throw new \InvalidArgumentException( 'Missing the required parameter $term when calling getApiV3TermsTerm' ); } $resourcePath = '/v3/terms/{term}'; $formParams = []; $queryParams = []; $headerParams = []; $httpBody = ''; $multipart = false; // query params $queryParams = array_merge($queryParams, ObjectSerializer::toQueryValue( $channels, 'channels', // param base name 'string', // openApiType 'form', // style true, // explode false // required ) ?? []); // query params $queryParams = array_merge($queryParams, ObjectSerializer::toQueryValue( $mode, 'mode', // param base name 'string', // openApiType 'form', // style true, // explode false // required ) ?? []); // query params $queryParams = array_merge($queryParams, ObjectSerializer::toQueryValue( $format, 'format', // param base name 'string', // openApiType 'form', // style true, // explode false // required ) ?? []); // path params if ($term !== null) { $resourcePath = str_replace( '{term}', ObjectSerializer::toPathValue($term), $resourcePath ); } $headers = $this->headerSelector->selectHeaders( ['application/json', 'application/problem+json', ], $contentType, $multipart ); // for model (json/xml) if (count($formParams) > 0) { if ($multipart) { $multipartContents = []; foreach ($formParams as $formParamName => $formParamValue) { $formParamValueItems = is_array($formParamValue) ? $formParamValue : [$formParamValue]; foreach ($formParamValueItems as $formParamValueItem) { $multipartContents[] = [ 'name' => $formParamName, 'contents' => $formParamValueItem ]; } } // for HTTP post (form) $httpBody = new MultipartStream($multipartContents); } elseif (stripos($headers['Content-Type'], 'application/json') !== false) { # if Content-Type contains "application/json", json_encode the form parameters try { $httpBody = json_encode($formParams, JSON_THROW_ON_ERROR); } catch (\JsonException $e) { throw new \InvalidArgumentException('json_encode error: ' . $e->getMessage(), 0, $e); } } else { // for HTTP post (form) $httpBody = ObjectSerializer::buildQuery($formParams); } } // this endpoint requires Bearer authentication (access token) if (!empty($this->config->getAccessToken())) { $headers['Authorization'] = 'Bearer ' . $this->config->getAccessToken(); } $defaultHeaders = []; if ($this->config->getUserAgent()) { $defaultHeaders['User-Agent'] = $this->config->getUserAgent(); } $headers = array_merge( $defaultHeaders, $headerParams, $headers ); $operationHost = $this->config->getHost(); $query = ObjectSerializer::buildQuery($queryParams); return new Request( 'GET', $operationHost . $resourcePath . ($query ? "?{$query}" : ''), $headers, $httpBody ); } /** * Operation patchApiV3TermsTerm * * 改术语 * * @param string $term 术语 id(guid) (required) * @param \WikipaliApi\Model\PatchApiV3TermsTermRequest|null $patch_api_v3_terms_term_request patch_api_v3_terms_term_request (optional) * @param string $contentType The value for the Content-Type header. Check self::contentTypes['patchApiV3TermsTerm'] to see the possible values for this operation * * @throws \WikipaliApi\ApiException on non-2xx response or if the response body is not in the expected format * @throws \InvalidArgumentException * @return \WikipaliApi\Model\PostApiV3ChannelsChannelTerms200Response|\WikipaliApi\Model\ProblemDetails|\WikipaliApi\Model\ProblemDetails|\WikipaliApi\Model\ProblemDetails|\WikipaliApi\Model\ProblemDetails|\WikipaliApi\Model\ProblemDetails */ public function patchApiV3TermsTerm($term, $patch_api_v3_terms_term_request = null, string $contentType = self::contentTypes['patchApiV3TermsTerm'][0]) { list($response) = $this->patchApiV3TermsTermWithHttpInfo($term, $patch_api_v3_terms_term_request, $contentType); return $response; } /** * Operation patchApiV3TermsTermWithHttpInfo * * 改术语 * * @param string $term 术语 id(guid) (required) * @param \WikipaliApi\Model\PatchApiV3TermsTermRequest|null $patch_api_v3_terms_term_request (optional) * @param string $contentType The value for the Content-Type header. Check self::contentTypes['patchApiV3TermsTerm'] to see the possible values for this operation * * @throws \WikipaliApi\ApiException on non-2xx response or if the response body is not in the expected format * @throws \InvalidArgumentException * @return array of \WikipaliApi\Model\PostApiV3ChannelsChannelTerms200Response|\WikipaliApi\Model\ProblemDetails|\WikipaliApi\Model\ProblemDetails|\WikipaliApi\Model\ProblemDetails|\WikipaliApi\Model\ProblemDetails|\WikipaliApi\Model\ProblemDetails, HTTP status code, HTTP response headers (array of strings) */ public function patchApiV3TermsTermWithHttpInfo($term, $patch_api_v3_terms_term_request = null, string $contentType = self::contentTypes['patchApiV3TermsTerm'][0]) { $request = $this->patchApiV3TermsTermRequest($term, $patch_api_v3_terms_term_request, $contentType); try { $options = $this->createHttpClientOption(); try { $response = $this->client->send($request, $options); } catch (RequestException $e) { throw new ApiException( "[{$e->getCode()}] {$e->getMessage()}", (int) $e->getCode(), $e->getResponse() ? $e->getResponse()->getHeaders() : null, $e->getResponse() ? (string) $e->getResponse()->getBody() : null ); } catch (ConnectException $e) { throw new ApiException( "[{$e->getCode()}] {$e->getMessage()}", (int) $e->getCode(), null, null ); } $statusCode = $response->getStatusCode(); switch($statusCode) { case 200: return $this->handleResponseWithDataType( '\WikipaliApi\Model\PostApiV3ChannelsChannelTerms200Response', $request, $response, ); case 401: return $this->handleResponseWithDataType( '\WikipaliApi\Model\ProblemDetails', $request, $response, ); case 403: return $this->handleResponseWithDataType( '\WikipaliApi\Model\ProblemDetails', $request, $response, ); case 412: return $this->handleResponseWithDataType( '\WikipaliApi\Model\ProblemDetails', $request, $response, ); case 422: return $this->handleResponseWithDataType( '\WikipaliApi\Model\ProblemDetails', $request, $response, ); case 428: return $this->handleResponseWithDataType( '\WikipaliApi\Model\ProblemDetails', $request, $response, ); } if ($statusCode < 200 || $statusCode > 299) { throw new ApiException( sprintf( '[%d] Error connecting to the API (%s)', $statusCode, (string) $request->getUri() ), $statusCode, $response->getHeaders(), (string) $response->getBody() ); } return $this->handleResponseWithDataType( '\WikipaliApi\Model\PostApiV3ChannelsChannelTerms200Response', $request, $response, ); } catch (ApiException $e) { switch ($e->getCode()) { case 200: $data = ObjectSerializer::deserialize( $e->getResponseBody(), '\WikipaliApi\Model\PostApiV3ChannelsChannelTerms200Response', $e->getResponseHeaders() ); $e->setResponseObject($data); throw $e; case 401: $data = ObjectSerializer::deserialize( $e->getResponseBody(), '\WikipaliApi\Model\ProblemDetails', $e->getResponseHeaders() ); $e->setResponseObject($data); throw $e; case 403: $data = ObjectSerializer::deserialize( $e->getResponseBody(), '\WikipaliApi\Model\ProblemDetails', $e->getResponseHeaders() ); $e->setResponseObject($data); throw $e; case 412: $data = ObjectSerializer::deserialize( $e->getResponseBody(), '\WikipaliApi\Model\ProblemDetails', $e->getResponseHeaders() ); $e->setResponseObject($data); throw $e; case 422: $data = ObjectSerializer::deserialize( $e->getResponseBody(), '\WikipaliApi\Model\ProblemDetails', $e->getResponseHeaders() ); $e->setResponseObject($data); throw $e; case 428: $data = ObjectSerializer::deserialize( $e->getResponseBody(), '\WikipaliApi\Model\ProblemDetails', $e->getResponseHeaders() ); $e->setResponseObject($data); throw $e; } throw $e; } } /** * Operation patchApiV3TermsTermAsync * * 改术语 * * @param string $term 术语 id(guid) (required) * @param \WikipaliApi\Model\PatchApiV3TermsTermRequest|null $patch_api_v3_terms_term_request (optional) * @param string $contentType The value for the Content-Type header. Check self::contentTypes['patchApiV3TermsTerm'] to see the possible values for this operation * * @throws \InvalidArgumentException * @return \GuzzleHttp\Promise\PromiseInterface */ public function patchApiV3TermsTermAsync($term, $patch_api_v3_terms_term_request = null, string $contentType = self::contentTypes['patchApiV3TermsTerm'][0]) { return $this->patchApiV3TermsTermAsyncWithHttpInfo($term, $patch_api_v3_terms_term_request, $contentType) ->then( function ($response) { return $response[0]; } ); } /** * Operation patchApiV3TermsTermAsyncWithHttpInfo * * 改术语 * * @param string $term 术语 id(guid) (required) * @param \WikipaliApi\Model\PatchApiV3TermsTermRequest|null $patch_api_v3_terms_term_request (optional) * @param string $contentType The value for the Content-Type header. Check self::contentTypes['patchApiV3TermsTerm'] to see the possible values for this operation * * @throws \InvalidArgumentException * @return \GuzzleHttp\Promise\PromiseInterface */ public function patchApiV3TermsTermAsyncWithHttpInfo($term, $patch_api_v3_terms_term_request = null, string $contentType = self::contentTypes['patchApiV3TermsTerm'][0]) { $returnType = '\WikipaliApi\Model\PostApiV3ChannelsChannelTerms200Response'; $request = $this->patchApiV3TermsTermRequest($term, $patch_api_v3_terms_term_request, $contentType); return $this->client ->sendAsync($request, $this->createHttpClientOption()) ->then( function ($response) use ($returnType) { if ($returnType === '\SplFileObject') { $content = $response->getBody(); //stream goes to serializer } else { $content = (string) $response->getBody(); if ($returnType !== 'string') { $content = json_decode($content); } } return [ ObjectSerializer::deserialize($content, $returnType, []), $response->getStatusCode(), $response->getHeaders() ]; }, function ($exception) { $response = $exception->getResponse(); $statusCode = $response->getStatusCode(); throw new ApiException( sprintf( '[%d] Error connecting to the API (%s)', $statusCode, $exception->getRequest()->getUri() ), $statusCode, $response->getHeaders(), (string) $response->getBody() ); } ); } /** * Create request for operation 'patchApiV3TermsTerm' * * @param string $term 术语 id(guid) (required) * @param \WikipaliApi\Model\PatchApiV3TermsTermRequest|null $patch_api_v3_terms_term_request (optional) * @param string $contentType The value for the Content-Type header. Check self::contentTypes['patchApiV3TermsTerm'] to see the possible values for this operation * * @throws \InvalidArgumentException * @return \GuzzleHttp\Psr7\Request */ public function patchApiV3TermsTermRequest($term, $patch_api_v3_terms_term_request = null, string $contentType = self::contentTypes['patchApiV3TermsTerm'][0]) { // verify the required parameter 'term' is set if ($term === null || (is_array($term) && count($term) === 0)) { throw new \InvalidArgumentException( 'Missing the required parameter $term when calling patchApiV3TermsTerm' ); } $resourcePath = '/v3/terms/{term}'; $formParams = []; $queryParams = []; $headerParams = []; $httpBody = ''; $multipart = false; // path params if ($term !== null) { $resourcePath = str_replace( '{term}', ObjectSerializer::toPathValue($term), $resourcePath ); } $headers = $this->headerSelector->selectHeaders( ['application/json', 'application/problem+json', ], $contentType, $multipart ); // for model (json/xml) if (isset($patch_api_v3_terms_term_request)) { if (stripos($headers['Content-Type'], 'application/json') !== false) { # if Content-Type contains "application/json", json_encode the body try { $httpBody = json_encode(ObjectSerializer::sanitizeForSerialization($patch_api_v3_terms_term_request), JSON_THROW_ON_ERROR); } catch (\JsonException $e) { throw new \InvalidArgumentException('json_encode error: ' . $e->getMessage(), 0, $e); } } else { $httpBody = $patch_api_v3_terms_term_request; } } elseif (count($formParams) > 0) { if ($multipart) { $multipartContents = []; foreach ($formParams as $formParamName => $formParamValue) { $formParamValueItems = is_array($formParamValue) ? $formParamValue : [$formParamValue]; foreach ($formParamValueItems as $formParamValueItem) { $multipartContents[] = [ 'name' => $formParamName, 'contents' => $formParamValueItem ]; } } // for HTTP post (form) $httpBody = new MultipartStream($multipartContents); } elseif (stripos($headers['Content-Type'], 'application/json') !== false) { # if Content-Type contains "application/json", json_encode the form parameters try { $httpBody = json_encode($formParams, JSON_THROW_ON_ERROR); } catch (\JsonException $e) { throw new \InvalidArgumentException('json_encode error: ' . $e->getMessage(), 0, $e); } } else { // for HTTP post (form) $httpBody = ObjectSerializer::buildQuery($formParams); } } // this endpoint requires Bearer authentication (access token) if (!empty($this->config->getAccessToken())) { $headers['Authorization'] = 'Bearer ' . $this->config->getAccessToken(); } $defaultHeaders = []; if ($this->config->getUserAgent()) { $defaultHeaders['User-Agent'] = $this->config->getUserAgent(); } $headers = array_merge( $defaultHeaders, $headerParams, $headers ); $operationHost = $this->config->getHost(); $query = ObjectSerializer::buildQuery($queryParams); return new Request( 'PATCH', $operationHost . $resourcePath . ($query ? "?{$query}" : ''), $headers, $httpBody ); } /** * Create http client option * * @throws \RuntimeException on file opening failure * @return array of http client options */ protected function createHttpClientOption() { $options = []; if ($this->config->getDebug()) { $options[RequestOptions::DEBUG] = fopen($this->config->getDebugFile(), 'a'); if (!$options[RequestOptions::DEBUG]) { throw new \RuntimeException('Failed to open the debug file: ' . $this->config->getDebugFile()); } } if ($this->config->getCertFile()) { $options[RequestOptions::CERT] = $this->config->getCertFile(); } if ($this->config->getKeyFile()) { $options[RequestOptions::SSL_KEY] = $this->config->getKeyFile(); } return $options; } private function handleResponseWithDataType( string $dataType, RequestInterface $request, ResponseInterface $response ): array { if ($dataType === '\SplFileObject') { $content = $response->getBody(); //stream goes to serializer } else { $content = (string) $response->getBody(); if ($dataType !== 'string') { try { $content = json_decode($content, false, 512, JSON_THROW_ON_ERROR); } catch (\JsonException $exception) { throw new ApiException( sprintf( 'Error JSON decoding server response (%s)', $request->getUri() ), $response->getStatusCode(), $response->getHeaders(), $content ); } } } return [ ObjectSerializer::deserialize($content, $dataType, []), $response->getStatusCode(), $response->getHeaders() ]; } private function responseWithinRangeCode( string $rangeCode, int $statusCode ): bool { $left = (int) ($rangeCode[0].'00'); $right = (int) ($rangeCode[0].'99'); return $statusCode >= $left && $statusCode <= $right; } }