Billhighway Cloud API

<back to all web services

KeyRequest

The following routes are available for this service:
POST/api/keys/generate
Imports System
Imports System.Collections
Imports System.Collections.Generic
Imports System.Runtime.Serialization
Imports ServiceStack
Imports ServiceStack.DataAnnotations
Imports BH.CloudAPI.Common4.DTO
Imports BH.CloudAPI.Common.DTO

Namespace Global

    Namespace BH.CloudAPI.Common.DTO

        Public Partial Class KeyResult
            Implements IHaveErrorField
            Public Sub New()
                KeyNameValuePairs = New Dictionary(Of String, Long)
            End Sub

            Public Overridable Property KeyNameValuePairs As Dictionary(Of String, Long)
            Public Overridable Property IsSuccessful As Boolean
            Public Overridable Property ErrorCode As Integer
            Public Overridable Property Message As String
            Public Overridable Property IsError As Boolean
        End Class
    End Namespace

    Namespace BH.CloudAPI.Common4.DTO

        Public Partial Class KeyRequest
            Inherits KeyRequest
        End Class
    End Namespace
End Namespace

VB.NET KeyRequest 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 /api/keys/generate HTTP/1.1 
Host: devapi.billhighway.com 
Accept: application/xml
Content-Type: application/xml
Content-Length: length

<KeyRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="https://www.billhighway.com/api">
  <DbName xmlns="http://schemas.datacontract.org/2004/07/BH.CloudAPI.Common.DTO">String</DbName>
  <Keys xmlns="http://schemas.datacontract.org/2004/07/BH.CloudAPI.Common.DTO">
    <Keys>
      <Name>String</Name>
      <NumberRequested>0</NumberRequested>
    </Keys>
  </Keys>
</KeyRequest>

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

<KeyResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/BH.CloudAPI.Common.DTO">
  <ErrorCode>0</ErrorCode>
  <IsSuccessful>false</IsSuccessful>
  <KeyNameValuePairs xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:KeyValueOfstringlong>
      <d2p1:Key>String</d2p1:Key>
      <d2p1:Value>0</d2p1:Value>
    </d2p1:KeyValueOfstringlong>
  </KeyNameValuePairs>
  <Message>String</Message>
</KeyResult>