3
0
corteza/api/crm/spec.json
2018-12-05 16:51:40 +01:00

881 lines
21 KiB
JSON

[
{
"title": "Fields",
"description": "CRM input field definitions",
"package": "crm",
"entrypoint": "field",
"path": "/field",
"authentication": [],
"struct": [],
"apis": [
{
"name": "list",
"method": "GET",
"path": "/",
"title": "List available fields"
},
{
"name": "type",
"path": "/{typeID}",
"method": "GET",
"title": "Get field details",
"parameters": {
"path": [
{
"type": "string",
"name": "typeID",
"required": true,
"title": "Type ID"
}
]
}
}
]
},
{
"title": "Workflows",
"description": "CRM workflow definitions",
"package": "crm",
"entrypoint": "workflow",
"path": "/workflow",
"authentication": [],
"struct": [
{
"imports": [
"github.com/crusttech/crust/crm/types"
]
}
],
"apis": [
{
"name": "list",
"method": "GET",
"path": "/",
"title": "List available workflows"
},
{
"name": "create",
"path": "/",
"method": "POST",
"title": "Create new workflow",
"parameters": {
"post": [
{
"type": "string",
"name": "name",
"required": true,
"title": "Workflow name"
},
{
"type": "types.WorkflowTaskSet",
"name": "tasks",
"required": false,
"title": "Type ID"
},
{
"type": "types.WorkflowTaskSet",
"name": "onError",
"required": false,
"title": "Type ID"
},
{
"type": "int",
"name": "timeout",
"required": false,
"title": "Timeout in seconds"
}
]
}
},
{
"name": "get",
"method": "GET",
"path": "/{workflowID}",
"title": "Get workflow details",
"parameters": {
"path": [
{
"type": "string",
"name": "workflowID",
"required": true,
"title": "Workflow ID"
}
]
}
},
{
"name": "update",
"method": "POST",
"path": "/{workflowID}",
"title": "Update workflow details",
"parameters": {
"path": [
{
"type": "string",
"name": "workflowID",
"required": true,
"title": "Workflow ID"
}
],
"post": [
{
"type": "string",
"name": "name",
"required": true,
"title": "Workflow name"
},
{
"type": "types.WorkflowTaskSet",
"name": "tasks",
"required": false,
"title": "Type ID"
},
{
"type": "types.WorkflowTaskSet",
"name": "onError",
"required": false,
"title": "Type ID"
},
{
"type": "int",
"name": "timeout",
"required": false,
"title": "Timeout in seconds"
}
]
}
},
{
"name": "delete",
"method": "DELETE",
"path": "/{workflowID}",
"title": "Delete workflow",
"parameters": {
"path": [
{
"type": "string",
"name": "workflowID",
"required": true,
"title": "Workflow ID"
}
]
}
}
]
},
{
"title": "Jobs",
"description": "Workflow Jobs",
"package": "crm",
"entrypoint": "job",
"path": "/job",
"authentication": [],
"struct": [
{
"imports": [
"github.com/crusttech/crust/crm/types",
"sqlxTypes github.com/jmoiron/sqlx/types"
]
}
],
"apis": [
{
"name": "list",
"method": "GET",
"path": "/",
"title": "List jobs",
"parameters": {
"get": [
{
"type": "string",
"name": "status",
"required": false,
"title": "Job status (`ok`, `error`, `running`, `cancelled` or `queued`)"
},
{
"name": "page",
"type": "int",
"required": false,
"title": "Page number (0 based)"
},
{
"name": "perPage",
"type": "int",
"required": false,
"title": "Returned items per page (default 50)"
}
]
}
},
{
"name": "run",
"path": "/",
"method": "POST",
"title": "Create a new job",
"parameters": {
"post": [
{
"type": "string",
"name": "workflowID",
"required": true,
"title": "Workflow ID"
},
{
"type": "string",
"name": "startAt",
"required": false,
"title": "Start datetime for a delayed job"
},
{
"type": "types.JobParameterSet",
"name": "parameters",
"required": false,
"title": "Extra job parameters (map[string]string)"
}
]
}
},
{
"name": "get",
"method": "GET",
"path": "/{jobID}",
"title": "Get job details",
"parameters": {
"path": [
{
"type": "string",
"name": "jobID",
"required": true,
"title": "Job ID"
}
]
}
},
{
"name": "logs",
"method": "GET",
"path": "/{jobID}/logs",
"title": "Get job logs",
"parameters": {
"path": [
{
"type": "string",
"name": "jobID",
"required": true,
"title": "Job ID"
},
{
"name": "page",
"type": "int",
"required": false,
"title": "Page number (0 based)"
},
{
"name": "perPage",
"type": "int",
"required": false,
"title": "Returned items per page (default 50)"
}
]
}
},
{
"name": "update",
"method": "POST",
"path": "/{jobID}",
"title": "Update job details",
"parameters": {
"path": [
{
"type": "string",
"name": "jobID",
"required": true,
"title": "Job ID"
}
],
"post": [
{
"type": "string",
"name": "status",
"required": false,
"title": "Job status (`ok`, `error`, `running`, `cancelled` or `queued`)"
},
{
"type": "sqlxTypes.JSONText",
"name": "log",
"required": false,
"title": "Job log item (append-only)"
},
{
"type": "string",
"name": "workflowID",
"required": false,
"title": "Workflow ID"
},
{
"type": "string",
"name": "startAt",
"required": false,
"title": "Start datetime for a delayed job"
},
{
"type": "types.JobParameterSet",
"name": "parameters",
"required": false,
"title": "Extra job parameters (map[string]string)"
}
]
}
},
{
"name": "delete",
"method": "DELETE",
"path": "/{jobID}",
"title": "Cancel job",
"parameters": {
"path": [
{
"type": "string",
"name": "jobID",
"required": true,
"title": "Job ID"
}
]
}
}
]
},
{
"title": "Pages",
"description": "CRM module pages",
"package": "crm",
"entrypoint": "page",
"path": "/page",
"authentication": [],
"struct": [
{
"imports": [
"sqlxTypes github.com/jmoiron/sqlx/types"
]
}
],
"apis": [
{
"name": "list",
"method": "GET",
"path": "/",
"title": "List available pages",
"parameters": {
"get": [
{
"type": "uint64",
"name": "selfID",
"required": false,
"title": "Parent page ID"
}
]
}
},
{
"name": "create",
"method": "POST",
"title": "Create page",
"path": "/",
"parameters": {
"post": [
{
"type": "uint64",
"name": "selfID",
"required": false,
"title": "Parent Page ID"
},
{
"type": "uint64",
"name": "moduleID",
"required": false,
"title": "Module ID"
},
{
"type": "string",
"name": "title",
"required": true,
"title": "Title"
},
{
"type": "string",
"name": "description",
"required": false,
"title": "Description"
},
{
"type": "bool",
"name": "visible",
"required": false,
"title": "Visible in navigation"
},
{
"type": "sqlxTypes.JSONText",
"name": "blocks",
"required": true,
"title": "Blocks JSON"
}
]
}
},
{
"name": "read",
"path": "/{pageID}",
"method": "GET",
"title": "Get page details",
"parameters": {
"path": [
{
"type": "uint64",
"name": "pageID",
"required": true,
"title": "Page ID"
}
]
}
},
{
"name": "tree",
"path": "/tree",
"method": "GET",
"title": "Get page all (non-record) pages, hierarchically",
"parameters": {}
},
{
"name": "edit",
"method": "POST",
"title": "Edit page",
"path": "/{pageID}",
"parameters": {
"path": [
{
"type": "uint64",
"name": "pageID",
"required": true,
"title": "Page ID"
}
],
"post": [
{
"type": "uint64",
"name": "selfID",
"required": false,
"title": "Parent Page ID"
},
{
"type": "uint64",
"name": "moduleID",
"required": false,
"title": "Module ID (optional)"
},
{
"type": "string",
"name": "title",
"required": true,
"title": "Title"
},
{
"type": "string",
"name": "description",
"required": false,
"title": "Description"
},
{
"type": "bool",
"name": "visible",
"required": false,
"title": "Visible in navigation"
},
{
"type": "sqlxTypes.JSONText",
"name": "blocks",
"required": true,
"title": "Blocks JSON"
}
]
}
},
{
"name": "reorder",
"method": "POST",
"title": "Reorder pages",
"path": "/{selfID}/reorder",
"parameters": {
"path": [
{
"type": "uint64",
"name": "selfID",
"required": true,
"title": "Parent page ID"
}
],
"post": [
{
"type": "[]string",
"name": "pageIDs",
"required": true,
"title": "Page ID order"
}
]
}
},
{
"name": "delete",
"path": "/{pageID}",
"method": "Delete",
"title": "Delete page",
"parameters": {
"path": [
{
"type": "uint64",
"name": "pageID",
"required": true,
"title": "Page ID"
}
]
}
}
]
},
{
"title": "Modules",
"description": "CRM module definitions",
"package": "crm",
"entrypoint": "module",
"path": "/module",
"authentication": [],
"struct": [
{
"imports": [
"sqlxTypes github.com/jmoiron/sqlx/types",
"github.com/crusttech/crust/crm/types"
]
}
],
"apis": [
{
"name": "list",
"method": "GET",
"title": "List modules",
"path": "/",
"parameters": {
"get": [
{
"type": "string",
"name": "query",
"required": false,
"title": "Search query"
}
]
}
},
{
"name": "create",
"method": "POST",
"title": "Create module",
"path": "/",
"parameters": {
"post": [
{
"type": "string",
"name": "name",
"required": true,
"title": "Module Name"
},
{
"type": "types.ModuleFieldSet",
"name": "fields",
"required": true,
"title": "Fields JSON"
}
]
}
},
{
"name": "read",
"method": "GET",
"title": "Read module",
"path": "/{moduleID}",
"parameters": {
"path": [
{
"type": "uint64",
"name": "moduleID",
"required": true,
"title": "Module ID"
}
]
}
},
{
"name": "chart",
"method": "GET",
"title": "Analyze data for chart",
"path": "/{moduleID}/chart",
"parameters": {
"path": [
{
"type": "uint64",
"name": "moduleID",
"required": true,
"title": "Module ID"
}
],
"get": [
{
"type": "string",
"name": "name",
"required": true,
"title": "The chart name"
},
{
"type": "string",
"name": "description",
"required": true,
"title": "The chart description"
},
{
"type": "string",
"name": "xAxis",
"required": true,
"title": "X axis value"
},
{
"type": "string",
"name": "xMin",
"required": false,
"title": "Min value"
},
{
"type": "string",
"name": "xMax",
"required": false,
"title": "Max value"
},
{
"type": "string",
"name": "yAxis",
"required": true,
"title": "Y axis value"
},
{
"type": "string",
"name": "groupBy",
"required": true,
"title": "Group by field"
},
{
"type": "string",
"name": "sum",
"required": true,
"title": "Sum values field"
},
{
"type": "string",
"name": "count",
"required": true,
"title": "Count values field"
},
{
"type": "string",
"name": "kind",
"required": true,
"title": "Chart kind (line, spline, step, area, area-spline, area-step, bar, scatter, pie, donut, gauge)"
}
]
}
},
{
"name": "edit",
"method": "POST",
"title": "Edit module",
"path": "/{moduleID}",
"parameters": {
"path": [
{
"type": "uint64",
"name": "moduleID",
"required": true,
"title": "Module ID"
}
],
"post": [
{
"type": "string",
"name": "name",
"required": true,
"title": "Module Name"
},
{
"type": "types.ModuleFieldSet",
"name": "fields",
"required": true,
"title": "Fields JSON"
}
]
}
},
{
"name": "delete",
"method": "DELETE",
"title": "Delete module",
"path": "/{moduleID}",
"parameters": {
"path": [
{
"type": "uint64",
"name": "moduleID",
"required": true,
"title": "Module ID"
}
]
}
},
{
"name": "content/list",
"method": "GET",
"title": "List/read contents from module section",
"path": "/{moduleID}/content",
"parameters": {
"path": [
{
"type": "uint64",
"name": "moduleID",
"required": true,
"title": "Module ID"
}
],
"get": [
{
"type": "string",
"name": "query",
"required": false,
"title": "Search query"
},
{
"name": "page",
"type": "int",
"required": false,
"title": "Page number (0 based)"
},
{
"name": "perPage",
"type": "int",
"required": false,
"title": "Returned items per page (default 50)"
},
{
"name": "sort",
"type": "string",
"required": false,
"title": "Sort field (default id desc)"
}
]
}
},
{
"name": "content/create",
"method": "POST",
"title": "List/read contents from module section",
"path": "/{moduleID}/content",
"parameters": {
"path": [
{
"type": "uint64",
"name": "moduleID",
"required": true,
"title": "Module ID"
}
],
"post": [
{
"type": "sqlxTypes.JSONText",
"name": "fields",
"required": true,
"title": "Content JSON"
}
]
}
},
{
"name": "content/read",
"method": "GET",
"title": "Read contents by ID from module section",
"path": "/{moduleID}/content/{contentID}",
"parameters": {
"path": [
{
"type": "uint64",
"name": "moduleID",
"required": true,
"title": "Module ID"
},
{
"type": "uint64",
"name": "contentID",
"required": true,
"title": "Content ID"
}
]
}
},
{
"name": "content/edit",
"method": "POST",
"title": "Add/update contents in module section",
"path": "/{moduleID}/content/{contentID}",
"parameters": {
"path": [
{
"type": "uint64",
"name": "moduleID",
"required": true,
"title": "Module ID"
},
{
"type": "uint64",
"name": "contentID",
"required": true,
"title": "Content ID"
}
],
"post": [
{
"type": "sqlxTypes.JSONText",
"name": "fields",
"required": true,
"title": "Content JSON"
}
]
}
},
{
"name": "content/delete",
"method": "DELETE",
"title": "Delete content row from module section",
"path": "/{moduleID}/content/{contentID}",
"parameters": {
"path": [
{
"type": "uint64",
"name": "moduleID",
"required": true,
"title": "Module ID"
},
{
"type": "uint64",
"name": "contentID",
"required": true,
"title": "Content ID"
}
]
}
}
]
}
]