BokaMera.API.Host

<back to all web services

CreateNewsItem

Requires Authentication
Requires any of the roles:bookingsupplier-administrator-write, superadmin
The following routes are available for this service:
POST/newsAdd a news itemAdd a news item to the company of the currently logged in user, only administrators are allowed to add news items.

export class NewsItemQueryResponse
{
    /** @description The news item id */
    // @ApiMember(Description="The news item id")
    public Id: number;

    /** @description Heading of the news item */
    // @ApiMember(Description="Heading of the news item")
    public Heading: string;

    /** @description Body of the news item */
    // @ApiMember(Description="Body of the news item")
    public Body: string;

    /** @description Url to a image associated with the news */
    // @ApiMember(Description="Url to a image associated with the news")
    public ImageUrl: string;

    /** @description The timestamp from which the newsitem should be visible from */
    // @ApiMember(Description="The timestamp from which the newsitem should be visible from", IsRequired=true)
    public From: string;

    /** @description The timestamp to which the newsitem should be visible to */
    // @ApiMember(Description="The timestamp to which the newsitem should be visible to", IsRequired=true)
    public To: string;

    /** @description The timestamp when news was created */
    // @ApiMember(Description="The timestamp when news was created", IsRequired=true)
    public Created: string;

    public ResponseStatus: ResponseStatus;

    public constructor(init?: Partial<NewsItemQueryResponse>) { (Object as any).assign(this, init); }
}

// @ValidateRequest(Validator="IsAuthenticated")
export class CreateNewsItem implements ICompany
{
    /** @description The company id, if empty will use the company id for the user you are logged in with. */
    // @ApiMember(Description="The company id, if empty will use the company id for the user you are logged in with.")
    public CompanyId?: string;

    /** @description The news item header, keep this short and concise */
    // @ApiMember(Description="The news item header, keep this short and concise", IsRequired=true)
    public Heading: string;

    /** @description The news body text */
    // @ApiMember(Description="The news body text", IsRequired=true)
    public Body: string;

    /** @description Valid url to a image associated with the news */
    // @ApiMember(Description="Valid url to a image associated with the news")
    public ImageUrl: string;

    /** @description The timestamp from which the newsitem should be visible from */
    // @ApiMember(Description="The timestamp from which the newsitem should be visible from", IsRequired=true)
    public From: string;

    /** @description The timestamp to which the newsitem should be visible to */
    // @ApiMember(Description="The timestamp to which the newsitem should be visible to", IsRequired=true)
    public To: string;

    public constructor(init?: Partial<CreateNewsItem>) { (Object as any).assign(this, init); }
}

TypeScript CreateNewsItem DTOs

To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=xml

HTTP + XML

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /news HTTP/1.1 
Host: testapi.bokamera.se 
Accept: application/xml
Content-Type: application/xml
Content-Length: length

<CreateNewsItem xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/BokaMera.API.ServiceModel.Dtos">
  <Body>String</Body>
  <CompanyId>00000000-0000-0000-0000-000000000000</CompanyId>
  <From>0001-01-01T00:00:00</From>
  <Heading>String</Heading>
  <ImageUrl i:nil="true" />
  <To>0001-01-01T00:00:00</To>
</CreateNewsItem>
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<NewsItemQueryResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/BokaMera.API.ServiceModel.Dtos">
  <Body>String</Body>
  <Created>0001-01-01T00:00:00</Created>
  <From>0001-01-01T00:00:00</From>
  <Heading>String</Heading>
  <Id>0</Id>
  <ImageUrl i:nil="true" />
  <ResponseStatus xmlns:d2p1="http://schemas.servicestack.net/types">
    <d2p1:ErrorCode>String</d2p1:ErrorCode>
    <d2p1:Message>String</d2p1:Message>
    <d2p1:StackTrace>String</d2p1:StackTrace>
    <d2p1:Errors>
      <d2p1:ResponseError>
        <d2p1:ErrorCode>String</d2p1:ErrorCode>
        <d2p1:FieldName>String</d2p1:FieldName>
        <d2p1:Message>String</d2p1:Message>
        <d2p1:Meta xmlns:d5p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
          <d5p1:KeyValueOfstringstring>
            <d5p1:Key>String</d5p1:Key>
            <d5p1:Value>String</d5p1:Value>
          </d5p1:KeyValueOfstringstring>
        </d2p1:Meta>
      </d2p1:ResponseError>
    </d2p1:Errors>
    <d2p1:Meta xmlns:d3p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
      <d3p1:KeyValueOfstringstring>
        <d3p1:Key>String</d3p1:Key>
        <d3p1:Value>String</d3p1:Value>
      </d3p1:KeyValueOfstringstring>
    </d2p1:Meta>
  </ResponseStatus>
  <To>0001-01-01T00:00:00</To>
</NewsItemQueryResponse>