Provide API to create a new developer marketplace service subscription

[cbryanreapit]

Overview

This endpoint will be responsible for creating a new marketplace subscriptions. Subscriptions are always associated to a developer, but can additionally be associated to a particular app or user that belongs to the developer organisation.

Location

POST /subscriptions (protected: yes)

Request

Payload

{
  "developerId" : "developerId",
  "applicationId" : "",
  "user" : "[email protected]",
  "type" : "developerEdition",
}

Validations

• developerId is required. Must be in acceptable format if provided.
• applicationId is optional. Must be provided type is 'applicationListing'. Must be in acceptable format if provided.
• user is optional. Must be in acceptable format if provided.
• type is required. Must be either applicationListing, developerEdition or developerRegistration.

Response

Success

201 Created

Failure

400 Bad Request
401 Authorised
403 Forbidden
422 Unprocessable Entity

Notes

• We will need a class per subscription type to govern price, frequency and display information. TBC.