| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617 |
- <?php
- /**
- * TermsApi
- * PHP version 8.1
- *
- * @category Class
- * @package WikipaliApi
- * @author OpenAPI Generator team
- * @link https://openapi-generator.tech
- */
- /**
- * MINT API
- *
- * International Academy Of Pali Tipitaka(国际巴利三藏学院) 由 `php openapi/scripts/generate.php` 依据 api-v13 的路由与控制器源码生成。 响应统一封装为 `{ok, message, data}`;`ok=false` 时 `message` 为错误信息。
- *
- * The version of the OpenAPI document: 1.0.0
- * Generated by: https://openapi-generator.tech
- * Generator version: 7.25.0
- */
- /**
- * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
- * https://openapi-generator.tech
- * Do not edit the class manually.
- */
- namespace WikipaliApi\Api;
- use GuzzleHttp\Client;
- use GuzzleHttp\ClientInterface;
- use GuzzleHttp\Exception\ConnectException;
- use GuzzleHttp\Exception\RequestException;
- use GuzzleHttp\Psr7\MultipartStream;
- use GuzzleHttp\Psr7\Request;
- use GuzzleHttp\RequestOptions;
- use Psr\Http\Message\RequestInterface;
- use Psr\Http\Message\ResponseInterface;
- use WikipaliApi\ApiException;
- use WikipaliApi\Configuration;
- use WikipaliApi\FormDataProcessor;
- use WikipaliApi\HeaderSelector;
- use WikipaliApi\ObjectSerializer;
- /**
- * TermsApi Class Doc Comment
- *
- * @category Class
- * @package WikipaliApi
- * @author OpenAPI Generator team
- * @link https://openapi-generator.tech
- */
- class TermsApi
- {
- /**
- * @var ClientInterface
- */
- protected $client;
- /**
- * @var Configuration
- */
- protected $config;
- /**
- * @var HeaderSelector
- */
- protected $headerSelector;
- /**
- * @var int Host index
- */
- protected $hostIndex;
- /** @var string[] $contentTypes **/
- public const contentTypes = [
- 'deleteApiV3TermsTerm' => [
- '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 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 bool|null $with_body 每条都带渲染后的正文 `body` (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, $per_page = 20, $tag = null, $channel = null, $language = null, $with_body = null, $page = null, string $contentType = self::contentTypes['getApiV3Terms'][0])
- {
- list($response) = $this->getApiV3TermsWithHttpInfo($word, $per_page, $tag, $channel, $language, $with_body, $page, $contentType);
- return $response;
- }
- /**
- * Operation getApiV3TermsWithHttpInfo
- *
- * 按词查术语
- *
- * @param string $word 巴利词,逗号分隔,最多 50 个 (required)
- * @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 bool|null $with_body 每条都带渲染后的正文 `body` (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, $per_page = 20, $tag = null, $channel = null, $language = null, $with_body = null, $page = null, string $contentType = self::contentTypes['getApiV3Terms'][0])
- {
- $request = $this->getApiV3TermsRequest($word, $per_page, $tag, $channel, $language, $with_body, $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 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 bool|null $with_body 每条都带渲染后的正文 `body` (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, $per_page = 20, $tag = null, $channel = null, $language = null, $with_body = null, $page = null, string $contentType = self::contentTypes['getApiV3Terms'][0])
- {
- return $this->getApiV3TermsAsyncWithHttpInfo($word, $per_page, $tag, $channel, $language, $with_body, $page, $contentType)
- ->then(
- function ($response) {
- return $response[0];
- }
- );
- }
- /**
- * Operation getApiV3TermsAsyncWithHttpInfo
- *
- * 按词查术语
- *
- * @param string $word 巴利词,逗号分隔,最多 50 个 (required)
- * @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 bool|null $with_body 每条都带渲染后的正文 `body` (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, $per_page = 20, $tag = null, $channel = null, $language = null, $with_body = null, $page = null, string $contentType = self::contentTypes['getApiV3Terms'][0])
- {
- $returnType = '\WikipaliApi\Model\GetApiV3ChannelsChannelTerms200Response';
- $request = $this->getApiV3TermsRequest($word, $per_page, $tag, $channel, $language, $with_body, $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 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 bool|null $with_body 每条都带渲染后的正文 `body` (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, $per_page = 20, $tag = null, $channel = null, $language = null, $with_body = 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(
- $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(
- $with_body,
- 'with_body', // param base name
- 'boolean', // 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;
- }
- }
|