BokaMera.API.Host

ApiVersionCompabilityQuery

The following routes are available for this service:
GET	/version/compability	Get information about whether your current version is compatible with the API version	Returns information on whether the client application's version is compatible with the current API version, indicating any breaking changes.

using System;
using System.IO;
using System.Collections;
using System.Collections.Generic;
using System.Runtime.Serialization;
using ServiceStack;
using ServiceStack.DataAnnotations;
using BokaMera.API.ServiceModel.Dtos;
using BokaMera.API.ServiceModel.Enums;

namespace BokaMera.API.ServiceModel.Dtos
{
    public partial class ApiVersionCompabilityQuery
    {
        ///<summary>
        ///The identifier for your application.
        ///</summary>
        [ApiMember(Description="The identifier for your application.", IsRequired=true, ParameterType="query")]
        public virtual VersionIdentifier Identifier { get; set; }

        ///<summary>
        ///The version you are running and you want to check
        ///</summary>
        [ApiMember(Description="The version you are running and you want to check", IsRequired=true, ParameterType="query")]
        public virtual string Version { get; set; }
    }

    public partial class ApiVersionCompabilityQueryResponse
    {
        ///<summary>
        ///The latest version number
        ///</summary>
        public virtual string CurrentVersion { get; set; }
        ///<summary>
        ///Your version number
        ///</summary>
        public virtual string YourVersion { get; set; }
        ///<summary>
        ///Any compatible error message
        ///</summary>
        public virtual string Message { get; set; }
        ///<summary>
        ///If your version is compatible with the current version
        ///</summary>
        public virtual bool Compatible { get; set; }
        ///<summary>
        ///If the changes are blocking for use and you need to upgrade to later version
        ///</summary>
        public virtual bool BlockingChanges { get; set; }
        public virtual ResponseStatus ResponseStatus { get; set; }
    }

}

namespace BokaMera.API.ServiceModel.Enums
{
    public enum VersionIdentifier
    {
        BokaMeraiOS = 1,
        BokaMeraAdminiOS = 2,
        BokaMeraAndroid = 3,
        BokaMeraAdminAndroid = 4,
    }

}

C# ApiVersionCompabilityQuery 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.

GET /version/compability HTTP/1.1 
Host: api.bookmore.com 
Accept: application/xml

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<ApiVersionCompabilityQueryResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/BokaMera.API.ServiceModel.Dtos">
  <BlockingChanges>false</BlockingChanges>
  <Compatible>false</Compatible>
  <CurrentVersion>String</CurrentVersion>
  <Message>String</Message>
  <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>
  <YourVersion>String</YourVersion>
</ApiVersionCompabilityQueryResponse>