3
0
corteza/api/compose/spec/namespace.json

203 lines
4.4 KiB
JSON

{
"Title": "Namespaces",
"Interface": "Namespace",
"Struct": [
{
"imports": [
"sqlxTypes github.com/jmoiron/sqlx/types",
"time"
]
}
],
"Parameters": {},
"Protocol": "",
"Authentication": [],
"Path": "/namespace",
"APIs": [
{
"Name": "list",
"Method": "GET",
"Title": "List namespaces",
"Path": "/",
"Parameters": {
"get": [
{
"name": "query",
"required": false,
"title": "Search query",
"type": "string"
},
{
"name": "slug",
"required": false,
"title": "Search by namespace slug",
"type": "string"
},
{
"name": "limit",
"title": "Limit",
"type": "uint"
},
{
"name": "offset",
"title": "Offset",
"type": "uint"
},
{
"name": "page",
"title": "Page number (1-based)",
"type": "uint"
},
{
"name": "perPage",
"title": "Returned items per page (default 50)",
"type": "uint"
},
{
"name": "sort",
"title": "Sort items",
"type": "string"
}
]
}
},
{
"Name": "create",
"Method": "POST",
"Title": "Create namespace",
"Path": "/",
"Parameters": {
"post": [
{
"name": "name",
"required": true,
"title": "Name",
"type": "string"
},
{
"name": "slug",
"required": false,
"title": "Slug (url path part)",
"type": "string"
},
{
"name": "enabled",
"required": false,
"title": "Enabled",
"type": "bool"
},
{
"name": "meta",
"required": true,
"title": "Meta data",
"type": "sqlxTypes.JSONText"
}
]
}
},
{
"Name": "read",
"Method": "GET",
"Title": "Read namespace",
"Path": "/{namespaceID}",
"Parameters": {
"path": [
{
"name": "namespaceID",
"required": true,
"title": "ID",
"type": "uint64"
}
]
}
},
{
"Name": "update",
"Method": "POST",
"Title": "Update namespace",
"Path": "/{namespaceID}",
"Parameters": {
"path": [
{
"name": "namespaceID",
"required": true,
"title": "ID",
"type": "uint64"
}
],
"post": [
{
"name": "name",
"required": true,
"title": "Name",
"type": "string"
},
{
"name": "slug",
"required": false,
"title": "Slug (url path part)",
"type": "string"
},
{
"name": "enabled",
"required": false,
"title": "Enabled",
"type": "bool"
},
{
"name": "meta",
"required": true,
"title": "Meta data",
"type": "sqlxTypes.JSONText"
},
{
"name": "updatedAt",
"required": false,
"title": "Last update (or creation) date",
"type": "*time.Time"
}
]
}
},
{
"Name": "delete",
"Method": "DELETE",
"Title": "Delete namespace",
"Path": "/{namespaceID}",
"Parameters": {
"path": [
{
"name": "namespaceID",
"required": true,
"title": "ID",
"type": "uint64"
}
]
}
},
{
"Name": "triggerScript",
"Method": "POST",
"Title": "Fire compose:namespace trigger",
"Path": "/{namespaceID}/trigger",
"Parameters": {
"path": [
{
"name": "namespaceID",
"required": true,
"title": "ID",
"type": "uint64"
}
],
"post": [
{
"name": "script",
"required": true,
"title": "Script to execute",
"type": "string"
}
]
}
}
]
}