ClubReady Api

<back to all web services

CreateUserNotesRequest

The following routes are available for this service:
POST/users/notes/createAdd multiple notes.
import Foundation
import ServiceStack

public class CreateUserNotesRequest : CreateUserNotesRequestDto, IRestrictedApiRequest
{
    /**
    * Api Key - grants access to resources
    */
    // @ApiMember(DataType="string", Description="Api Key - grants access to resources", IsRequired=true, Name="ApiKey", ParameterType="query")
    public var apiKey:String

    /**
    * ClubReady Club ID (StoreID internally)
    */
    // @ApiMember(DataType="integer", Description="ClubReady Club ID (StoreID internally)", IsRequired=true, Name="StoreId", ParameterType="query")
    public var storeId:Int?

    /**
    * Notes are being posted by this ClubReady User ID.
    */
    // @ApiMember(DataType="integer", Description="Notes are being posted by this ClubReady User ID.", Name="PostedBy", ParameterType="query")
    public var postedBy:Int?

    /**
    * Create notes
    */
    // @ApiMember(Description="Create notes", IsRequired=true, Name="UserNotes")
    public var userNotes:[SubmittedNote] = []

    public var restrictedId:Int?
    public var restrictedResourceType:RestrictedResourceType

    required public init(){ super.init() }

    private enum CodingKeys : String, CodingKey {
        case apiKey
        case storeId
        case postedBy
        case userNotes
        case restrictedId
        case restrictedResourceType
    }

    required public init(from decoder: Decoder) throws {
        try super.init(from: decoder)
        let container = try decoder.container(keyedBy: CodingKeys.self)
        apiKey = try container.decodeIfPresent(String.self, forKey: .apiKey)
        storeId = try container.decodeIfPresent(Int.self, forKey: .storeId)
        postedBy = try container.decodeIfPresent(Int.self, forKey: .postedBy)
        userNotes = try container.decodeIfPresent([SubmittedNote].self, forKey: .userNotes) ?? []
        restrictedId = try container.decodeIfPresent(Int.self, forKey: .restrictedId)
        restrictedResourceType = try container.decodeIfPresent(RestrictedResourceType.self, forKey: .restrictedResourceType)
    }

    public override func encode(to encoder: Encoder) throws {
        try super.encode(to: encoder)
        var container = encoder.container(keyedBy: CodingKeys.self)
        if apiKey != nil { try container.encode(apiKey, forKey: .apiKey) }
        if storeId != nil { try container.encode(storeId, forKey: .storeId) }
        if postedBy != nil { try container.encode(postedBy, forKey: .postedBy) }
        if userNotes.count > 0 { try container.encode(userNotes, forKey: .userNotes) }
        if restrictedId != nil { try container.encode(restrictedId, forKey: .restrictedId) }
        if restrictedResourceType != nil { try container.encode(restrictedResourceType, forKey: .restrictedResourceType) }
    }
}

public class CreateUserNotesRequestDto : ApiDtoBase
{
    public var postedBy:Int?
    public var userNotes:[SubmittedNote] = []

    required public init(){ super.init() }

    private enum CodingKeys : String, CodingKey {
        case postedBy
        case userNotes
    }

    required public init(from decoder: Decoder) throws {
        try super.init(from: decoder)
        let container = try decoder.container(keyedBy: CodingKeys.self)
        postedBy = try container.decodeIfPresent(Int.self, forKey: .postedBy)
        userNotes = try container.decodeIfPresent([SubmittedNote].self, forKey: .userNotes) ?? []
    }

    public override func encode(to encoder: Encoder) throws {
        try super.encode(to: encoder)
        var container = encoder.container(keyedBy: CodingKeys.self)
        if postedBy != nil { try container.encode(postedBy, forKey: .postedBy) }
        if userNotes.count > 0 { try container.encode(userNotes, forKey: .userNotes) }
    }
}

public class ApiDtoBase : Codable
{
    public var apiKey:String
    public var storeId:Int?
    public var chainId:Int?

    required public init(){}
}

public class SubmittedNote : Codable
{
    public var userId:Int
    public var subject:String
    public var text:String

    required public init(){}
}

public enum RestrictedResourceType : String, Codable
{
    case Store
    case Chain
    case User
    case Undefined
}

public class CreateUserNotesResponse : CreateUserNotesResponseDto
{
    public var noteIds:[Int] = []

    required public init(){ super.init() }

    private enum CodingKeys : String, CodingKey {
        case noteIds
    }

    required public init(from decoder: Decoder) throws {
        try super.init(from: decoder)
        let container = try decoder.container(keyedBy: CodingKeys.self)
        noteIds = try container.decodeIfPresent([Int].self, forKey: .noteIds) ?? []
    }

    public override func encode(to encoder: Encoder) throws {
        try super.encode(to: encoder)
        var container = encoder.container(keyedBy: CodingKeys.self)
        if noteIds.count > 0 { try container.encode(noteIds, forKey: .noteIds) }
    }
}

public class CreateUserNotesResponseDto : ApiResponseBase
{
    public var noteIds:[Int] = []

    required public init(){ super.init() }

    private enum CodingKeys : String, CodingKey {
        case noteIds
    }

    required public init(from decoder: Decoder) throws {
        try super.init(from: decoder)
        let container = try decoder.container(keyedBy: CodingKeys.self)
        noteIds = try container.decodeIfPresent([Int].self, forKey: .noteIds) ?? []
    }

    public override func encode(to encoder: Encoder) throws {
        try super.encode(to: encoder)
        var container = encoder.container(keyedBy: CodingKeys.self)
        if noteIds.count > 0 { try container.encode(noteIds, forKey: .noteIds) }
    }
}

public class ApiResponseBase : Codable
{
    public var success:Bool
    public var message:String

    required public init(){}
}

Swift CreateUserNotesRequest DTOs

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

To embed the response in a jsonp callback, append ?callback=myCallback

HTTP + JSON

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

POST /users/notes/create HTTP/1.1 
Host: clubready.com 
Accept: application/json
Content-Type: application/json
Content-Length: length

{"ApiKey":"String","StoreId":0,"PostedBy":0,"UserNotes":[{"UserId":0,"Subject":"String","Text":"String"}],"RestrictedId":0,"RestrictedResourceType":"Store","ChainId":0}

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

{"NoteIds":[0],"Success":false,"Message":"String"}