a.Attribute("commit")
a.Attribute("buildTime")
a.Attribute("startTime")
a.Attribute("error")
})
})
// workItem is the media type for work items
// Deprecated, but kept around as internal model for now.
var workItem = a.MediaType("application/vnd.workitem+json", func() {
a.TypeName("WorkItem")
a.Description("A work item hold field values according to a given field type")
a.Attribute("id", d.String, "unique id per installation")
a.Attribute("version", d.Integer, "Version for optimistic concurrency control")
a.Attribute("type", d.String, "Name of the type of this work item")
a.Attribute("fields", a.HashOf(d.String, d.Any), "The field values, according to the field type")
a.Required("id")
a.Required("version")
a.Required("type")
a.Required("fields")
a.View("default", func() {
a.Attribute("id")
a.Attribute("version")
a.Attribute("type")
a.Attribute("fields")
})
})
var pagingLinks = a.Type("pagingLinks", func() {
package design
import (
d "github.com/goadesign/goa/design"
a "github.com/goadesign/goa/design/apidsl"
)
// genericLinksForWorkItem defines generic relations links that are specific to a workitem
var genericLinksForWorkItem = a.Type("GenericLinksForWorkItem", func() {
a.Attribute("self", d.String)
a.Attribute("related", d.String)
a.Attribute("sourceLinkTypes", d.String, `URL to those work item link types
in which the current work item can be used in the source part of the link`)
a.Attribute("targetLinkTypes", d.String, `URL to those work item link types
in which the current work item can be used in the target part of the link`)
a.Attribute("meta", a.HashOf(d.String, d.Any))
})
// workItem2 defines how an update payload will look like
var workItem2 = a.Type("WorkItem2", func() {
a.Attribute("type", d.String, func() {
a.Enum("workitems")
})
a.Attribute("id", d.String, "ID of the work item which is being updated", func() {
a.Example("42")
})
a.Attribute("attributes", a.HashOf(d.String, d.Any), func() {
a.Example(map[string]interface{}{"version": "1", "system.state": "new", "system.title": "Example story"})
})
a.Attribute("relationships", workItemRelationships)
a.Attribute("links", genericLinksForWorkItem)
package design
import (
d "github.com/goadesign/goa/design"
a "github.com/goadesign/goa/design/apidsl"
)
var _ = a.Resource("userspace", func() {
a.BasePath("/userspace")
a.Action("create", func() {
a.Routing(
a.PUT("/*"),
)
a.Description("Data dump endpoint ")
a.Payload(a.HashOf(d.String, d.Any))
a.Response(d.NoContent)
a.Response(d.InternalServerError)
})
a.Action("show", func() {
a.Routing(
a.GET("/*"),
)
a.Description("Data dump endpoint ")
a.Response(d.OK, a.HashOf(d.String, d.Any))
a.Response(d.InternalServerError)
a.Response(d.NotFound)
})
})
package design
import (
d "github.com/goadesign/goa/design"
a "github.com/goadesign/goa/design/apidsl"
)
// CreateWorkItemPayload defines the structure of work item payload
var CreateWorkItemPayload = a.Type("CreateWorkItemPayload", func() {
a.Attribute("type", d.String, "The type of the newly created work item", func() {
a.Example("userstory")
a.MinLength(1)
a.Pattern("^[\\p{L}.]+$")
})
a.Attribute("fields", a.HashOf(d.String, d.Any), "The field values, must conform to the type", func() {
a.Example(map[string]interface{}{"system.creator": "user-ref", "system.state": "new", "system.title": "Example story"})
a.MinLength(1)
})
a.Required("type", "fields")
})
// UpdateWorkItemPayload has been added because the design.WorkItem could
// not be used since it mandated the presence of the ID in the payload
// which ideally should be optional. The ID should be passed on to REST URL.
var UpdateWorkItemPayload = a.Type("UpdateWorkItemPayload", func() {
a.Attribute("type", d.String, "The type of the newly created work item", func() {
a.Example("userstory")
a.MinLength(1)
a.Pattern("^[\\p{L}.]+$")
})
a.Attribute("fields", a.HashOf(d.String, d.Any), "The field values, must conform to the type", func() {
a "github.com/goadesign/goa/design/apidsl"
)
//#############################################################################
//
// JSONAPI common
//
//#############################################################################
// JSONAPILink represents a JSONAPI link object (see http://jsonapi.org/format/#document-links)
var JSONAPILink = a.Type("JSONAPILink", func() {
a.Description(`See also http://jsonapi.org/format/#document-links.`)
a.Attribute("href", d.String, "a string containing the link's URL.", func() {
a.Example("http://example.com/articles/1/comments")
})
a.Attribute("meta", a.HashOf(d.String, d.Any), "a meta object containing non-standard meta-information about the link.")
})
// JSONAPIError represents a JSONAPI error object (see http://jsonapi.org/format/#error-objects)
var JSONAPIError = a.Type("JSONAPIError", func() {
a.Description(`Error objects provide additional information about problems encountered while
performing an operation. Error objects MUST be returned as an array keyed by errors in the
top level of a JSON API document.
See. also http://jsonapi.org/format/#error-objects.`)
a.Attribute("id", d.String, "a unique identifier for this particular occurrence of the problem.")
a.Attribute("links", a.HashOf(d.String, JSONAPILink), `a links object containing the following members:
* about: a link that leads to further details about this particular occurrence of the problem.`)
a.Attribute("status", d.String, "the HTTP status code applicable to this problem, expressed as a string value.")
a.Attribute("code", d.String, "an application-specific error code, expressed as a string value.")