| POST | /v1/links/pending |
|---|
<?php namespace dtos;
use DateTime;
use Exception;
use DateInterval;
use JsonSerializable;
use ServiceStack\{IReturn,IReturnVoid,IGet,IPost,IPut,IDelete,IPatch,IMeta,IHasSessionId,IHasBearerToken,IHasVersion};
use ServiceStack\{ICrud,ICreateDb,IUpdateDb,IPatchDb,IDeleteDb,ISaveDb,AuditBase,QueryDb,QueryDb2,QueryData,QueryData2,QueryResponse};
use ServiceStack\{ResponseStatus,ResponseError,EmptyResponse,IdResponse,ArrayList,KeyValuePair2,StringResponse,StringsResponse,Tuple2,Tuple3,ByteArray};
use ServiceStack\{JsonConverters,Returns,TypeContext};
// @DataContract
class ProductMetadata extends ProductMetadata implements JsonSerializable
{
/**
* @param string|null $title
* @param string|null $author
* @param string|null $url
* @param string|null $description
* @param string|null $retailer
* @param array<string,string>|null $productImages
*/
public function __construct(
?string $title=null,
?string $author=null,
?string $url=null,
?string $description=null,
?string $retailer=null,
?array $productImages=null
) {
parent::__construct($title,$author,$url,$description,$retailer,$productImages);
}
/** @throws Exception */
public function fromMap($o): void {
parent::fromMap($o);
}
/** @throws Exception */
public function jsonSerialize(): mixed
{
$o = parent::jsonSerialize();
return empty($o) ? new class(){} : $o;
}
}
// @DataContract
class PostPendingLinkResponse implements JsonSerializable
{
public function __construct(
// @DataMember(Name="url")
/** @var string|null */
public ?string $url=null,
// @DataMember(Name="productMetadata")
/** @var ProductMetadata|null */
public ?ProductMetadata $productMetadata=null,
// @DataMember(Name="domain")
/** @var string|null */
public ?string $domain=null,
// @DataMember(Name="code")
/** @var string|null */
public ?string $code=null,
// @DataMember(Name="baseDomain")
/** @var string|null */
public ?string $baseDomain=null,
// @DataMember(Name="baseCode")
/** @var string|null */
public ?string $baseCode=null,
// @DataMember(Name="responseStatus")
/** @var ResponseStatus|null */
public ?ResponseStatus $responseStatus=null
) {
}
/** @throws Exception */
public function fromMap($o): void {
if (isset($o['url'])) $this->url = $o['url'];
if (isset($o['productMetadata'])) $this->productMetadata = JsonConverters::from('ProductMetadata', $o['productMetadata']);
if (isset($o['domain'])) $this->domain = $o['domain'];
if (isset($o['code'])) $this->code = $o['code'];
if (isset($o['baseDomain'])) $this->baseDomain = $o['baseDomain'];
if (isset($o['baseCode'])) $this->baseCode = $o['baseCode'];
if (isset($o['responseStatus'])) $this->responseStatus = JsonConverters::from('ResponseStatus', $o['responseStatus']);
}
/** @throws Exception */
public function jsonSerialize(): mixed
{
$o = [];
if (isset($this->url)) $o['url'] = $this->url;
if (isset($this->productMetadata)) $o['productMetadata'] = JsonConverters::to('ProductMetadata', $this->productMetadata);
if (isset($this->domain)) $o['domain'] = $this->domain;
if (isset($this->code)) $o['code'] = $this->code;
if (isset($this->baseDomain)) $o['baseDomain'] = $this->baseDomain;
if (isset($this->baseCode)) $o['baseCode'] = $this->baseCode;
if (isset($this->responseStatus)) $o['responseStatus'] = JsonConverters::to('ResponseStatus', $this->responseStatus);
return empty($o) ? new class(){} : $o;
}
}
// @DataContract
class PostPendingLinkRequest implements JsonSerializable
{
public function __construct(
// @DataMember(Name="token")
// @ApiMember(IsRequired=true, Name="token")
/** @var string */
public string $token=''
) {
}
/** @throws Exception */
public function fromMap($o): void {
if (isset($o['token'])) $this->token = $o['token'];
}
/** @throws Exception */
public function jsonSerialize(): mixed
{
$o = [];
if (isset($this->token)) $o['token'] = $this->token;
return empty($o) ? new class(){} : $o;
}
}
// @DataContract
class ProductMetadata implements JsonSerializable
{
public function __construct(
// @DataMember(Name="title")
/** @var string|null */
public ?string $title=null,
// @DataMember(Name="author")
/** @var string|null */
public ?string $author=null,
// @DataMember(Name="url")
/** @var string|null */
public ?string $url=null,
// @DataMember(Name="description")
/** @var string|null */
public ?string $description=null,
// @DataMember(Name="retailer")
/** @var string|null */
public ?string $retailer=null,
// @DataMember(Name="productImages")
/** @var array<string,string>|null */
public ?array $productImages=null
) {
}
/** @throws Exception */
public function fromMap($o): void {
if (isset($o['title'])) $this->title = $o['title'];
if (isset($o['author'])) $this->author = $o['author'];
if (isset($o['url'])) $this->url = JsonConverters::from('string', $o['url']);
if (isset($o['description'])) $this->description = $o['description'];
if (isset($o['retailer'])) $this->retailer = $o['retailer'];
if (isset($o['productImages'])) $this->productImages = JsonConverters::from(JsonConverters::context('Dictionary',genericArgs:['string','Uri']), $o['productImages']);
}
/** @throws Exception */
public function jsonSerialize(): mixed
{
$o = [];
if (isset($this->title)) $o['title'] = $this->title;
if (isset($this->author)) $o['author'] = $this->author;
if (isset($this->url)) $o['url'] = JsonConverters::to('string', $this->url);
if (isset($this->description)) $o['description'] = $this->description;
if (isset($this->retailer)) $o['retailer'] = $this->retailer;
if (isset($this->productImages)) $o['productImages'] = JsonConverters::to(JsonConverters::context('Dictionary',genericArgs:['string','Uri']), $this->productImages);
return empty($o) ? new class(){} : $o;
}
}
PHP PostPendingLinkRequest DTOs
To override the Content-type in your clients, use the HTTP Accept Header, append the .other suffix or ?format=other
The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.
POST /v1/links/pending HTTP/1.1
Host: api.booklinker.com
Accept: text/jsonl
Content-Type: text/jsonl
Content-Length: length
{"token":"String"}
HTTP/1.1 200 OK
Content-Type: text/jsonl
Content-Length: length
{"url":"String","productMetadata":{"title":"String","author":"String","description":"String","retailer":"String"},"domain":"String","code":"String","baseDomain":"String","baseCode":"String","responseStatus":{"errorCode":"String","message":"String","stackTrace":"String","errors":[{"errorCode":"String","fieldName":"String","message":"String","meta":{"String":"String"}}],"meta":{"String":"String"}}}