mirror of https://github.com/nocodb/nocodb
Raju Udava
12 months ago
committed by
GitHub
13 changed files with 1140 additions and 14 deletions
@ -0,0 +1,28 @@ |
|||||||
|
import { getModelPaths } from './templates/paths'; |
||||||
|
import type { Model } from '~/models'; |
||||||
|
import type { SwaggerColumn } from './getSwaggerColumnMetas'; |
||||||
|
import type { SwaggerView } from './getSwaggerJSONV2'; |
||||||
|
import Noco from '~/Noco'; |
||||||
|
|
||||||
|
export default async function getPaths( |
||||||
|
{ |
||||||
|
model, |
||||||
|
columns, |
||||||
|
views, |
||||||
|
}: { |
||||||
|
model: Model; |
||||||
|
columns: SwaggerColumn[]; |
||||||
|
views: SwaggerView[]; |
||||||
|
}, |
||||||
|
_ncMeta = Noco.ncMeta, |
||||||
|
) { |
||||||
|
const swaggerPaths = await getModelPaths({ |
||||||
|
tableName: model.title, |
||||||
|
tableId: model.id, |
||||||
|
views, |
||||||
|
type: model.type, |
||||||
|
columns, |
||||||
|
}); |
||||||
|
|
||||||
|
return swaggerPaths; |
||||||
|
} |
@ -0,0 +1,29 @@ |
|||||||
|
import { getModelSchemas, getViewSchemas } from './templates/schemas'; |
||||||
|
import type { Base, Model } from '~/models'; |
||||||
|
|
||||||
|
import type { SwaggerColumn } from './getSwaggerColumnMetas'; |
||||||
|
import type { SwaggerView } from './getSwaggerJSONV2'; |
||||||
|
import Noco from '~/Noco'; |
||||||
|
|
||||||
|
export default async function getSchemas( |
||||||
|
{ |
||||||
|
base, |
||||||
|
model, |
||||||
|
columns |
||||||
|
}: { |
||||||
|
base: Base; |
||||||
|
model: Model; |
||||||
|
columns: SwaggerColumn[]; |
||||||
|
views: SwaggerView[]; |
||||||
|
}, |
||||||
|
_ncMeta = Noco.ncMeta, |
||||||
|
) { |
||||||
|
const swaggerSchemas = getModelSchemas({ |
||||||
|
tableName: model.title, |
||||||
|
orgs: 'v1', |
||||||
|
baseName: base.title, |
||||||
|
columns, |
||||||
|
}); |
||||||
|
|
||||||
|
return swaggerSchemas; |
||||||
|
} |
@ -0,0 +1,67 @@ |
|||||||
|
import { UITypes } from 'nocodb-sdk'; |
||||||
|
import type { Base, Column, LinkToAnotherRecordColumn } from '~/models'; |
||||||
|
import SwaggerTypes from '~/db/sql-mgr/code/routers/xc-ts/SwaggerTypes'; |
||||||
|
import Noco from '~/Noco'; |
||||||
|
|
||||||
|
export default async ( |
||||||
|
columns: Column[], |
||||||
|
base: Base, |
||||||
|
ncMeta = Noco.ncMeta, |
||||||
|
): Promise<SwaggerColumn[]> => { |
||||||
|
const dbType = await base.getBases().then((b) => b?.[0]?.type); |
||||||
|
return Promise.all( |
||||||
|
columns.map(async (c) => { |
||||||
|
const field: SwaggerColumn = { |
||||||
|
title: c.title, |
||||||
|
type: 'object', |
||||||
|
virtual: true, |
||||||
|
column: c, |
||||||
|
}; |
||||||
|
|
||||||
|
switch (c.uidt) { |
||||||
|
case UITypes.LinkToAnotherRecord: |
||||||
|
{ |
||||||
|
const colOpt = await c.getColOptions<LinkToAnotherRecordColumn>( |
||||||
|
ncMeta, |
||||||
|
); |
||||||
|
if (colOpt) { |
||||||
|
const relTable = await colOpt.getRelatedTable(ncMeta); |
||||||
|
field.type = undefined; |
||||||
|
field.$ref = `#/components/schemas/${relTable.title}Request`; |
||||||
|
} |
||||||
|
} |
||||||
|
break; |
||||||
|
case UITypes.Formula: |
||||||
|
case UITypes.Lookup: |
||||||
|
field.type = 'object'; |
||||||
|
break; |
||||||
|
case UITypes.Rollup: |
||||||
|
case UITypes.Links: |
||||||
|
field.type = 'number'; |
||||||
|
break; |
||||||
|
case UITypes.Attachment: |
||||||
|
field.type = 'array'; |
||||||
|
field.items = { |
||||||
|
$ref: `#/components/schemas/Attachment`, |
||||||
|
}; |
||||||
|
break; |
||||||
|
default: |
||||||
|
field.virtual = false; |
||||||
|
SwaggerTypes.setSwaggerType(c, field, dbType); |
||||||
|
break; |
||||||
|
} |
||||||
|
|
||||||
|
return field; |
||||||
|
}), |
||||||
|
); |
||||||
|
}; |
||||||
|
|
||||||
|
export interface SwaggerColumn { |
||||||
|
type: any; |
||||||
|
title: string; |
||||||
|
description?: string; |
||||||
|
virtual?: boolean; |
||||||
|
$ref?: any; |
||||||
|
column: Column; |
||||||
|
items?: any; |
||||||
|
} |
@ -0,0 +1,66 @@ |
|||||||
|
import { ViewTypes } from 'nocodb-sdk'; |
||||||
|
import swaggerBase from './swagger-base.json'; |
||||||
|
import getPaths from './getPaths'; |
||||||
|
import getSchemas from './getSchemas'; |
||||||
|
import getSwaggerColumnMetas from './getSwaggerColumnMetas'; |
||||||
|
import type { |
||||||
|
Base, |
||||||
|
FormViewColumn, |
||||||
|
GalleryViewColumn, |
||||||
|
GridViewColumn, |
||||||
|
Model, |
||||||
|
View, |
||||||
|
} from '~/models'; |
||||||
|
import Noco from '~/Noco'; |
||||||
|
|
||||||
|
export default async function getSwaggerJSONV2( |
||||||
|
base: Base, |
||||||
|
models: Model[], |
||||||
|
ncMeta = Noco.ncMeta, |
||||||
|
) { |
||||||
|
// base swagger object
|
||||||
|
const swaggerObj = { |
||||||
|
...swaggerBase, |
||||||
|
paths: {}, |
||||||
|
components: { |
||||||
|
...swaggerBase.components, |
||||||
|
schemas: { ...swaggerBase.components.schemas }, |
||||||
|
}, |
||||||
|
}; |
||||||
|
|
||||||
|
// iterate and populate swagger schema and path for models and views
|
||||||
|
for (const model of models) { |
||||||
|
let paths = {}; |
||||||
|
|
||||||
|
const columns = await getSwaggerColumnMetas( |
||||||
|
await model.getColumns(ncMeta), |
||||||
|
base, |
||||||
|
ncMeta, |
||||||
|
); |
||||||
|
|
||||||
|
const views: SwaggerView[] = []; |
||||||
|
|
||||||
|
for (const view of (await model.getViews(false, ncMeta)) || []) { |
||||||
|
if (view.type !== ViewTypes.GRID) continue; |
||||||
|
views.push({ |
||||||
|
view, |
||||||
|
columns: await view.getColumns(ncMeta), |
||||||
|
}); |
||||||
|
} |
||||||
|
|
||||||
|
// skip mm tables
|
||||||
|
if (!model.mm) paths = await getPaths({ model, columns, views }, ncMeta); |
||||||
|
|
||||||
|
const schemas = await getSchemas({ base, model, columns, views }, ncMeta); |
||||||
|
|
||||||
|
Object.assign(swaggerObj.paths, paths); |
||||||
|
Object.assign(swaggerObj.components.schemas, schemas); |
||||||
|
} |
||||||
|
|
||||||
|
return swaggerObj; |
||||||
|
} |
||||||
|
|
||||||
|
export interface SwaggerView { |
||||||
|
view: View; |
||||||
|
columns: Array<GridViewColumn | GalleryViewColumn | FormViewColumn>; |
||||||
|
} |
@ -0,0 +1,128 @@ |
|||||||
|
{ |
||||||
|
"openapi": "3.0.0", |
||||||
|
"info": { |
||||||
|
"title": "nocodb", |
||||||
|
"version": "2.0" |
||||||
|
}, |
||||||
|
"servers": [ |
||||||
|
{ |
||||||
|
"url": "http://localhost:8080" |
||||||
|
} |
||||||
|
], |
||||||
|
"paths": { |
||||||
|
}, |
||||||
|
"components": { |
||||||
|
"schemas": { |
||||||
|
"Paginated": { |
||||||
|
"title": "Paginated", |
||||||
|
"type": "object", |
||||||
|
"properties": { |
||||||
|
"pageSize": { |
||||||
|
"type": "integer" |
||||||
|
}, |
||||||
|
"totalRows": { |
||||||
|
"type": "integer" |
||||||
|
}, |
||||||
|
"isFirstPage": { |
||||||
|
"type": "boolean" |
||||||
|
}, |
||||||
|
"isLastPage": { |
||||||
|
"type": "boolean" |
||||||
|
}, |
||||||
|
"page": { |
||||||
|
"type": "number" |
||||||
|
} |
||||||
|
} |
||||||
|
}, |
||||||
|
"Attachment": { |
||||||
|
"title": "Attachment", |
||||||
|
"type": "object", |
||||||
|
"properties": { |
||||||
|
"mimetype": { |
||||||
|
"type": "string" |
||||||
|
}, |
||||||
|
"size": { |
||||||
|
"type": "integer" |
||||||
|
}, |
||||||
|
"title": { |
||||||
|
"type": "string" |
||||||
|
}, |
||||||
|
"url": { |
||||||
|
"type": "string" |
||||||
|
}, |
||||||
|
"icon": { |
||||||
|
"type": "string" |
||||||
|
} |
||||||
|
} |
||||||
|
}, |
||||||
|
"Groupby": { |
||||||
|
"title": "Groupby", |
||||||
|
"type": "object", |
||||||
|
"properties": { |
||||||
|
"count": { |
||||||
|
"type": "number", |
||||||
|
"description": "count" |
||||||
|
}, |
||||||
|
"column_name": { |
||||||
|
"type": "string", |
||||||
|
"description": "the value of the given column" |
||||||
|
} |
||||||
|
} |
||||||
|
} |
||||||
|
}, |
||||||
|
"securitySchemes": { |
||||||
|
"xcAuth": { |
||||||
|
"type": "apiKey", |
||||||
|
"in": "header", |
||||||
|
"name": "xc-auth", |
||||||
|
"description": "JWT access token" |
||||||
|
}, |
||||||
|
"xcToken": { |
||||||
|
"type": "apiKey", |
||||||
|
"in": "header", |
||||||
|
"name": "xc-token", |
||||||
|
"description": "API token" |
||||||
|
} |
||||||
|
}, |
||||||
|
"responses": { |
||||||
|
"BadRequest": { |
||||||
|
"description": "BadReqeust", |
||||||
|
"content": { |
||||||
|
"application/json": { |
||||||
|
"schema": { |
||||||
|
"type": "object", |
||||||
|
"properties": { |
||||||
|
"msg": { |
||||||
|
"type": "string", |
||||||
|
"x-stoplight": { |
||||||
|
"id": "p9mk4oi0hbihm" |
||||||
|
}, |
||||||
|
"example": "BadRequest [Error]: <ERROR MESSAGE>" |
||||||
|
} |
||||||
|
}, |
||||||
|
"required": [ |
||||||
|
"msg" |
||||||
|
] |
||||||
|
}, |
||||||
|
"examples": { |
||||||
|
"Example 1": { |
||||||
|
"value": { |
||||||
|
"msg": "BadRequest [Error]: <ERROR MESSAGE>" |
||||||
|
} |
||||||
|
} |
||||||
|
} |
||||||
|
} |
||||||
|
}, |
||||||
|
"headers": {} |
||||||
|
} |
||||||
|
} |
||||||
|
}, |
||||||
|
"security": [ |
||||||
|
{ |
||||||
|
"xcAuth": [] |
||||||
|
}, |
||||||
|
{ |
||||||
|
"xcToken": [] |
||||||
|
} |
||||||
|
] |
||||||
|
} |
@ -0,0 +1,10 @@ |
|||||||
|
export const csvExportResponseHeader = { |
||||||
|
'nc-export-offset': { |
||||||
|
schema: { |
||||||
|
type: 'integer', |
||||||
|
}, |
||||||
|
description: |
||||||
|
'Offset of next set of data which will be helpful if there is large amount of data. It will returns `-1` if all set of data exported.', |
||||||
|
example: '1000', |
||||||
|
}, |
||||||
|
}; |
@ -0,0 +1,237 @@ |
|||||||
|
import { isLinksOrLTAR, RelationTypes, UITypes } from 'nocodb-sdk'; |
||||||
|
import type { LinkToAnotherRecordColumn } from '~/models'; |
||||||
|
import type { SwaggerColumn } from '../getSwaggerColumnMetas'; |
||||||
|
import type { SwaggerView } from '~/services/api-docs/swaggerV2/getSwaggerJSONV2'; |
||||||
|
|
||||||
|
export const recordIdParam = { |
||||||
|
schema: { |
||||||
|
type: 'string', |
||||||
|
}, |
||||||
|
name: 'recordId', |
||||||
|
in: 'path', |
||||||
|
required: true, |
||||||
|
example: 1, |
||||||
|
description: |
||||||
|
'Primary key of the record you want to read. If the table have composite primary key then combine them by using `___` and pass it as primary key.', |
||||||
|
}; |
||||||
|
export const fieldsParam = { |
||||||
|
schema: { |
||||||
|
type: 'string', |
||||||
|
}, |
||||||
|
in: 'query', |
||||||
|
name: 'fields', |
||||||
|
description: |
||||||
|
'Array of field names or comma separated filed names to include in the response objects. In array syntax pass it like `fields[]=field1&fields[]=field2` or alternately `fields=field1,field2`.', |
||||||
|
}; |
||||||
|
export const sortParam = { |
||||||
|
schema: { |
||||||
|
type: 'string', |
||||||
|
}, |
||||||
|
in: 'query', |
||||||
|
name: 'sort', |
||||||
|
description: |
||||||
|
'Comma separated field names to sort rows, rows will sort in ascending order based on provided columns. To sort in descending order provide `-` prefix along with column name, like `-field`. Example : `sort=field1,-field2`', |
||||||
|
}; |
||||||
|
export const whereParam = { |
||||||
|
schema: { |
||||||
|
type: 'string', |
||||||
|
}, |
||||||
|
in: 'query', |
||||||
|
name: 'where', |
||||||
|
description: |
||||||
|
'This can be used for filtering rows, which accepts complicated where conditions. For more info visit [here](https://docs.nocodb.com/developer-resources/rest-apis#comparison-operators). Example : `where=(field1,eq,value)`', |
||||||
|
}; |
||||||
|
export const limitParam = { |
||||||
|
schema: { |
||||||
|
type: 'number', |
||||||
|
minimum: 1, |
||||||
|
}, |
||||||
|
in: 'query', |
||||||
|
name: 'limit', |
||||||
|
description: |
||||||
|
'The `limit` parameter used for pagination, the response collection size depends on limit value with default value `25` and maximum value `1000`, which can be overridden by environment variables `DB_QUERY_LIMIT_DEFAULT` and `DB_QUERY_LIMIT_MAX` respectively.', |
||||||
|
example: 25, |
||||||
|
}; |
||||||
|
export const offsetParam = { |
||||||
|
schema: { |
||||||
|
type: 'number', |
||||||
|
minimum: 0, |
||||||
|
}, |
||||||
|
in: 'query', |
||||||
|
name: 'offset', |
||||||
|
description: |
||||||
|
'The `offset` parameter used for pagination, the value helps to select collection from a certain index.', |
||||||
|
example: 0, |
||||||
|
}; |
||||||
|
|
||||||
|
export const shuffleParam = { |
||||||
|
schema: { |
||||||
|
type: 'number', |
||||||
|
minimum: 0, |
||||||
|
maximum: 1, |
||||||
|
}, |
||||||
|
in: 'query', |
||||||
|
name: 'shuffle', |
||||||
|
description: |
||||||
|
'The `shuffle` parameter used for pagination, the response will be shuffled if it is set to 1.', |
||||||
|
example: 0, |
||||||
|
}; |
||||||
|
|
||||||
|
export const columnNameQueryParam = { |
||||||
|
schema: { |
||||||
|
type: 'string', |
||||||
|
}, |
||||||
|
in: 'query', |
||||||
|
name: 'column_name', |
||||||
|
description: |
||||||
|
'Column name of the column you want to group by, eg. `column_name=column1`', |
||||||
|
}; |
||||||
|
|
||||||
|
export const linkFieldNameParam = (columns: SwaggerColumn[]) => { |
||||||
|
const linkColumnIds = []; |
||||||
|
const description = [ |
||||||
|
'**Links Field Identifier** corresponding to the relation field `Links` established between tables.\n\nLink Columns:', |
||||||
|
]; |
||||||
|
for (const { column } of columns) { |
||||||
|
if (!isLinksOrLTAR(column) || column.system) continue; |
||||||
|
linkColumnIds.push(column.id); |
||||||
|
|
||||||
|
description.push(`* ${column.id} - ${column.title}`); |
||||||
|
} |
||||||
|
|
||||||
|
return { |
||||||
|
schema: { |
||||||
|
type: 'string', |
||||||
|
enum: linkColumnIds, |
||||||
|
}, |
||||||
|
name: 'linkFieldId', |
||||||
|
in: 'path', |
||||||
|
required: true, |
||||||
|
description: description.join('\n'), |
||||||
|
}; |
||||||
|
}; |
||||||
|
export const viewIdParams = (views: SwaggerView[]) => { |
||||||
|
const viewIds = []; |
||||||
|
const description = [ |
||||||
|
'Allows you to fetch records that are currently visible within a specific view.\n\nViews:', |
||||||
|
]; |
||||||
|
|
||||||
|
for (const { view } of views) { |
||||||
|
viewIds.push(view.id); |
||||||
|
description.push( |
||||||
|
`* ${view.id} - ${view.is_default ? 'Default view' : view.title}`, |
||||||
|
); |
||||||
|
} |
||||||
|
|
||||||
|
return { |
||||||
|
schema: { |
||||||
|
type: 'string', |
||||||
|
enum: viewIds, |
||||||
|
}, |
||||||
|
description: description.join('\n'), |
||||||
|
name: 'viewId', |
||||||
|
in: 'query', |
||||||
|
required: false, |
||||||
|
}; |
||||||
|
}; |
||||||
|
|
||||||
|
export const referencedRowIdParam = { |
||||||
|
schema: { |
||||||
|
type: 'string', |
||||||
|
}, |
||||||
|
name: 'refRowId', |
||||||
|
in: 'path', |
||||||
|
required: true, |
||||||
|
}; |
||||||
|
|
||||||
|
export const exportTypeParam = { |
||||||
|
schema: { |
||||||
|
type: 'string', |
||||||
|
enum: ['csv', 'excel'], |
||||||
|
}, |
||||||
|
name: 'type', |
||||||
|
in: 'path', |
||||||
|
required: true, |
||||||
|
}; |
||||||
|
|
||||||
|
export const csvExportOffsetParam = { |
||||||
|
schema: { |
||||||
|
type: 'number', |
||||||
|
minimum: 0, |
||||||
|
}, |
||||||
|
in: 'query', |
||||||
|
name: 'offset', |
||||||
|
description: |
||||||
|
'Helps to start export from a certain index. You can get the next set of data offset from previous response header named `nc-export-offset`.', |
||||||
|
example: 0, |
||||||
|
}; |
||||||
|
|
||||||
|
export const nestedWhereParam = (colName) => ({ |
||||||
|
schema: { |
||||||
|
type: 'string', |
||||||
|
}, |
||||||
|
in: 'query', |
||||||
|
name: `nested[${colName}][where]`, |
||||||
|
description: `This can be used for filtering rows in nested column \`${colName}\`, which accepts complicated where conditions. For more info visit [here](https://docs.nocodb.com/developer-resources/rest-apis#comparison-operators). Example : \`nested[${colName}][where]=(field1,eq,value)\``, |
||||||
|
}); |
||||||
|
|
||||||
|
export const nestedFieldParam = (colName) => ({ |
||||||
|
schema: { |
||||||
|
type: 'string', |
||||||
|
}, |
||||||
|
in: 'query', |
||||||
|
name: `nested[${colName}][fields]`, |
||||||
|
description: `Array of field names or comma separated filed names to include in the in nested column \`${colName}\` result. In array syntax pass it like \`fields[]=field1&fields[]=field2.\`. Example : \`nested[${colName}][fields]=field1,field2\``, |
||||||
|
}); |
||||||
|
export const nestedSortParam = (colName) => ({ |
||||||
|
schema: { |
||||||
|
type: 'string', |
||||||
|
}, |
||||||
|
in: 'query', |
||||||
|
name: `nested[${colName}][sort]`, |
||||||
|
description: `Comma separated field names to sort rows in nested column \`${colName}\` rows, it will sort in ascending order based on provided columns. To sort in descending order provide \`-\` prefix along with column name, like \`-field\`. Example : \`nested[${colName}][sort]=field1,-field2\``, |
||||||
|
}); |
||||||
|
export const nestedLimitParam = (colName) => ({ |
||||||
|
schema: { |
||||||
|
type: 'number', |
||||||
|
minimum: 1, |
||||||
|
}, |
||||||
|
in: 'query', |
||||||
|
name: `nested[${colName}][limit]`, |
||||||
|
description: `The \`limit\` parameter used for pagination of nested \`${colName}\` rows, the response collection size depends on limit value and default value is \`25\`.`, |
||||||
|
example: '25', |
||||||
|
}); |
||||||
|
export const nestedOffsetParam = (colName) => ({ |
||||||
|
schema: { |
||||||
|
type: 'number', |
||||||
|
minimum: 0, |
||||||
|
}, |
||||||
|
in: 'query', |
||||||
|
name: `nested[${colName}][offset]`, |
||||||
|
description: `The \`offset\` parameter used for pagination of nested \`${colName}\` rows, the value helps to select collection from a certain index.`, |
||||||
|
example: 0, |
||||||
|
}); |
||||||
|
|
||||||
|
export const getNestedParams = async ( |
||||||
|
columns: SwaggerColumn[], |
||||||
|
): Promise<any[]> => { |
||||||
|
return await columns.reduce(async (paramsArr, { column }) => { |
||||||
|
if (column.uidt === UITypes.LinkToAnotherRecord && !column.system) { |
||||||
|
const colOpt = await column.getColOptions<LinkToAnotherRecordColumn>(); |
||||||
|
if (colOpt.type !== RelationTypes.BELONGS_TO) { |
||||||
|
return [ |
||||||
|
...(await paramsArr), |
||||||
|
nestedWhereParam(column.title), |
||||||
|
nestedOffsetParam(column.title), |
||||||
|
nestedLimitParam(column.title), |
||||||
|
nestedFieldParam(column.title), |
||||||
|
nestedSortParam(column.title), |
||||||
|
]; |
||||||
|
} else { |
||||||
|
return [...(await paramsArr), nestedFieldParam(column.title)]; |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
return paramsArr; |
||||||
|
}, Promise.resolve([])); |
||||||
|
}; |
@ -0,0 +1,407 @@ |
|||||||
|
import { ModelTypes } from 'nocodb-sdk'; |
||||||
|
import { |
||||||
|
fieldsParam, |
||||||
|
getNestedParams, |
||||||
|
limitParam, |
||||||
|
linkFieldNameParam, |
||||||
|
offsetParam, |
||||||
|
recordIdParam, |
||||||
|
shuffleParam, |
||||||
|
sortParam, |
||||||
|
viewIdParams, |
||||||
|
whereParam, |
||||||
|
} from './params'; |
||||||
|
import type { SwaggerColumn } from '../getSwaggerColumnMetas'; |
||||||
|
import type { SwaggerView } from '~/services/api-docs/swaggerV2/getSwaggerJSONV2'; |
||||||
|
import { isRelationExist } from '~/services/api-docs/swagger/templates/paths'; |
||||||
|
|
||||||
|
export const getModelPaths = async (ctx: { |
||||||
|
tableName: string; |
||||||
|
type: ModelTypes; |
||||||
|
columns: SwaggerColumn[]; |
||||||
|
tableId: string; |
||||||
|
views: SwaggerView[]; |
||||||
|
}): Promise<{ [path: string]: any }> => ({ |
||||||
|
[`/api/v2/tables/${ctx.tableId}/records`]: { |
||||||
|
get: { |
||||||
|
summary: `${ctx.tableName} list`, |
||||||
|
operationId: `${ctx.tableName.toLowerCase()}-db-table-row-list`, |
||||||
|
description: `List of all rows from ${ctx.tableName} ${ctx.type} and response data fields can be filtered based on query params.`, |
||||||
|
tags: [ctx.tableName], |
||||||
|
parameters: [ |
||||||
|
viewIdParams(ctx.views), |
||||||
|
fieldsParam, |
||||||
|
sortParam, |
||||||
|
whereParam, |
||||||
|
limitParam, |
||||||
|
shuffleParam, |
||||||
|
offsetParam, |
||||||
|
...(await getNestedParams(ctx.columns)), |
||||||
|
], |
||||||
|
responses: { |
||||||
|
'200': { |
||||||
|
description: 'OK', |
||||||
|
content: { |
||||||
|
'application/json': { |
||||||
|
schema: getPaginatedResponseType(`${ctx.tableName}Response`), |
||||||
|
}, |
||||||
|
}, |
||||||
|
}, |
||||||
|
}, |
||||||
|
}, |
||||||
|
...(ctx.type === ModelTypes.TABLE |
||||||
|
? { |
||||||
|
post: { |
||||||
|
summary: `${ctx.tableName} create`, |
||||||
|
description: |
||||||
|
'Insert a new row in table by providing a key value pair object where key refers to the column alias. All the required fields should be included with payload excluding `autoincrement` and column with default value.', |
||||||
|
operationId: `${ctx.tableName.toLowerCase()}-create`, |
||||||
|
responses: { |
||||||
|
'200': { |
||||||
|
description: 'OK', |
||||||
|
content: { |
||||||
|
'application/json': { |
||||||
|
schema: { |
||||||
|
$ref: `#/components/schemas/${ctx.tableName}Response`, |
||||||
|
}, |
||||||
|
}, |
||||||
|
}, |
||||||
|
}, |
||||||
|
'400': { |
||||||
|
$ref: '#/components/responses/BadRequest', |
||||||
|
}, |
||||||
|
}, |
||||||
|
tags: [ctx.tableName], |
||||||
|
requestBody: { |
||||||
|
content: { |
||||||
|
'application/json': { |
||||||
|
schema: { |
||||||
|
oneOf: [ |
||||||
|
{ |
||||||
|
$ref: `#/components/schemas/${ctx.tableName}Request`, |
||||||
|
}, |
||||||
|
{ |
||||||
|
type: 'array', |
||||||
|
items: { |
||||||
|
$ref: `#/components/schemas/${ctx.tableName}Request`, |
||||||
|
}, |
||||||
|
}, |
||||||
|
], |
||||||
|
}, |
||||||
|
}, |
||||||
|
}, |
||||||
|
}, |
||||||
|
}, |
||||||
|
patch: { |
||||||
|
summary: `${ctx.tableName} update`, |
||||||
|
operationId: `${ctx.tableName.toLowerCase()}-update`, |
||||||
|
description: |
||||||
|
'Partial update row in table by providing a key value pair object where key refers to the column alias. You need to only include columns which you want to update.', |
||||||
|
responses: { |
||||||
|
'200': { |
||||||
|
description: 'OK', |
||||||
|
content: { |
||||||
|
'application/json': { |
||||||
|
schema: {}, |
||||||
|
}, |
||||||
|
}, |
||||||
|
}, |
||||||
|
'400': { |
||||||
|
$ref: '#/components/responses/BadRequest', |
||||||
|
}, |
||||||
|
}, |
||||||
|
tags: [ctx.tableName], |
||||||
|
requestBody: { |
||||||
|
content: { |
||||||
|
'application/json': { |
||||||
|
schema: { |
||||||
|
oneOf: [ |
||||||
|
{ |
||||||
|
$ref: `#/components/schemas/${ctx.tableName}Request`, |
||||||
|
}, |
||||||
|
{ |
||||||
|
type: 'array', |
||||||
|
items: { |
||||||
|
$ref: `#/components/schemas/${ctx.tableName}Request`, |
||||||
|
}, |
||||||
|
}, |
||||||
|
], |
||||||
|
}, |
||||||
|
}, |
||||||
|
}, |
||||||
|
}, |
||||||
|
}, |
||||||
|
delete: { |
||||||
|
summary: `${ctx.tableName} delete`, |
||||||
|
operationId: `${ctx.tableName.toLowerCase()}-delete`, |
||||||
|
responses: { |
||||||
|
'200': { |
||||||
|
description: 'OK', |
||||||
|
}, |
||||||
|
}, |
||||||
|
tags: [ctx.tableName], |
||||||
|
description: |
||||||
|
'Delete a row by using the **primary key** column value.', |
||||||
|
requestBody: { |
||||||
|
content: { |
||||||
|
'application/json': { |
||||||
|
schema: { |
||||||
|
oneOf: [ |
||||||
|
{ |
||||||
|
$ref: `#/components/schemas/${ctx.tableName}IdRequest`, |
||||||
|
}, |
||||||
|
{ |
||||||
|
type: 'array', |
||||||
|
items: { |
||||||
|
$ref: `#/components/schemas/${ctx.tableName}IdRequest`, |
||||||
|
}, |
||||||
|
}, |
||||||
|
], |
||||||
|
}, |
||||||
|
}, |
||||||
|
}, |
||||||
|
}, |
||||||
|
}, |
||||||
|
} |
||||||
|
: {}), |
||||||
|
}, |
||||||
|
[`/api/v2/tables/${ctx.tableId}/records/{recordId}`]: { |
||||||
|
get: { |
||||||
|
parameters: [recordIdParam, fieldsParam], |
||||||
|
summary: `${ctx.tableName} read`, |
||||||
|
description: 'Read a row data by using the **primary key** column value.', |
||||||
|
operationId: `${ctx.tableName.toLowerCase()}-read`, |
||||||
|
tags: [ctx.tableName], |
||||||
|
responses: { |
||||||
|
'201': { |
||||||
|
description: 'Created', |
||||||
|
content: { |
||||||
|
'application/json': { |
||||||
|
schema: { |
||||||
|
$ref: `#/components/schemas/${ctx.tableName}Response`, |
||||||
|
}, |
||||||
|
}, |
||||||
|
}, |
||||||
|
}, |
||||||
|
}, |
||||||
|
}, |
||||||
|
}, |
||||||
|
[`/api/v2/tables/${ctx.tableId}/records/count`]: { |
||||||
|
parameters: [viewIdParams(ctx.views)], |
||||||
|
get: { |
||||||
|
summary: `${ctx.tableName} count`, |
||||||
|
operationId: `${ctx.tableName.toLowerCase()}-count`, |
||||||
|
description: 'Get rows count of a table by applying optional filters.', |
||||||
|
tags: [ctx.tableName], |
||||||
|
parameters: [whereParam], |
||||||
|
responses: { |
||||||
|
'200': { |
||||||
|
description: 'OK', |
||||||
|
content: { |
||||||
|
'application/json': { |
||||||
|
schema: { |
||||||
|
type: 'object', |
||||||
|
properties: { |
||||||
|
count: { |
||||||
|
type: 'number', |
||||||
|
}, |
||||||
|
}, |
||||||
|
required: ['list', 'pageInfo'], |
||||||
|
}, |
||||||
|
examples: { |
||||||
|
'Example 1': { |
||||||
|
value: { |
||||||
|
count: 3, |
||||||
|
}, |
||||||
|
}, |
||||||
|
}, |
||||||
|
}, |
||||||
|
}, |
||||||
|
}, |
||||||
|
'400': { |
||||||
|
$ref: '#/components/responses/BadRequest', |
||||||
|
}, |
||||||
|
}, |
||||||
|
}, |
||||||
|
}, |
||||||
|
|
||||||
|
...(isRelationExist(ctx.columns) |
||||||
|
? { |
||||||
|
[`/api/v2/tables/${ctx.tableId}/links/{linkFieldId}/records/{recordId}`]: |
||||||
|
{ |
||||||
|
parameters: [linkFieldNameParam(ctx.columns), recordIdParam], |
||||||
|
get: { |
||||||
|
summary: 'Link Records list', |
||||||
|
operationId: `${ctx.tableName.toLowerCase()}-nested-list`, |
||||||
|
description: |
||||||
|
'This API endpoint allows you to retrieve list of linked records for a specific `Link field` and `Record ID`. The response is an array of objects containing Primary Key and its corresponding display value.', |
||||||
|
tags: [ctx.tableName], |
||||||
|
parameters: [ |
||||||
|
fieldsParam, |
||||||
|
sortParam, |
||||||
|
whereParam, |
||||||
|
limitParam, |
||||||
|
offsetParam, |
||||||
|
], |
||||||
|
responses: { |
||||||
|
'200': { |
||||||
|
description: 'OK', |
||||||
|
content: { |
||||||
|
'application/json': { |
||||||
|
schema: { |
||||||
|
type: 'object', |
||||||
|
properties: { |
||||||
|
list: { |
||||||
|
type: 'array', |
||||||
|
description: 'List of data objects', |
||||||
|
items: { |
||||||
|
type: 'object', |
||||||
|
}, |
||||||
|
}, |
||||||
|
pageInfo: { |
||||||
|
$ref: '#/components/schemas/Paginated', |
||||||
|
description: 'Paginated Info', |
||||||
|
}, |
||||||
|
}, |
||||||
|
required: ['list', 'pageInfo'], |
||||||
|
}, |
||||||
|
}, |
||||||
|
}, |
||||||
|
}, |
||||||
|
'400': { |
||||||
|
$ref: '#/components/responses/BadRequest', |
||||||
|
}, |
||||||
|
}, |
||||||
|
}, |
||||||
|
post: { |
||||||
|
summary: 'Link Records', |
||||||
|
operationId: `${ctx.tableName.toLowerCase()}-nested-link`, |
||||||
|
responses: { |
||||||
|
'200': { |
||||||
|
description: 'OK', |
||||||
|
content: { |
||||||
|
'application/json': { |
||||||
|
schema: {}, |
||||||
|
examples: { |
||||||
|
'Example 1': { |
||||||
|
value: true, |
||||||
|
}, |
||||||
|
}, |
||||||
|
}, |
||||||
|
}, |
||||||
|
}, |
||||||
|
'400': { |
||||||
|
$ref: '#/components/responses/BadRequest', |
||||||
|
}, |
||||||
|
}, |
||||||
|
tags: [ctx.tableName], |
||||||
|
requestBody: { |
||||||
|
content: { |
||||||
|
'application/json': { |
||||||
|
schema: { |
||||||
|
oneOf: [ |
||||||
|
{ |
||||||
|
type: 'object', |
||||||
|
}, |
||||||
|
{ |
||||||
|
type: 'array', |
||||||
|
items: { |
||||||
|
type: 'object', |
||||||
|
}, |
||||||
|
}, |
||||||
|
], |
||||||
|
}, |
||||||
|
examples: { |
||||||
|
'Example 1': { |
||||||
|
value: [ |
||||||
|
{ |
||||||
|
Id: 4, |
||||||
|
}, |
||||||
|
{ |
||||||
|
Id: 5, |
||||||
|
}, |
||||||
|
], |
||||||
|
}, |
||||||
|
}, |
||||||
|
}, |
||||||
|
}, |
||||||
|
}, |
||||||
|
description: |
||||||
|
'This API endpoint allows you to link records to a specific `Link field` and `Record ID`. The request payload is an array of record-ids from the adjacent table for linking purposes. Note that any existing links, if present, will be unaffected during this operation.', |
||||||
|
parameters: [recordIdParam], |
||||||
|
}, |
||||||
|
delete: { |
||||||
|
summary: 'Unlink Records', |
||||||
|
operationId: `${ctx.tableName.toLowerCase()}-nested-unlink`, |
||||||
|
responses: { |
||||||
|
'200': { |
||||||
|
description: 'OK', |
||||||
|
content: { |
||||||
|
'application/json': { |
||||||
|
schema: {}, |
||||||
|
examples: { |
||||||
|
'Example 1': { |
||||||
|
value: true, |
||||||
|
}, |
||||||
|
}, |
||||||
|
}, |
||||||
|
}, |
||||||
|
}, |
||||||
|
'400': { |
||||||
|
$ref: '#/components/responses/BadRequest', |
||||||
|
}, |
||||||
|
}, |
||||||
|
tags: [ctx.tableName], |
||||||
|
requestBody: { |
||||||
|
content: { |
||||||
|
'application/json': { |
||||||
|
schema: { |
||||||
|
oneOf: [ |
||||||
|
{ |
||||||
|
type: 'array', |
||||||
|
items: { |
||||||
|
type: 'object', |
||||||
|
}, |
||||||
|
}, |
||||||
|
], |
||||||
|
}, |
||||||
|
examples: { |
||||||
|
'Example 1': { |
||||||
|
value: [ |
||||||
|
{ |
||||||
|
Id: 1, |
||||||
|
}, |
||||||
|
{ |
||||||
|
Id: 2, |
||||||
|
}, |
||||||
|
], |
||||||
|
}, |
||||||
|
}, |
||||||
|
}, |
||||||
|
}, |
||||||
|
}, |
||||||
|
description: |
||||||
|
'This API endpoint allows you to unlink records from a specific `Link field` and `Record ID`. The request payload is an array of record-ids from the adjacent table for unlinking purposes. Note that, \n- duplicated record-ids will be ignored.\n- non-existent record-ids will be ignored.', |
||||||
|
parameters: [recordIdParam], |
||||||
|
}, |
||||||
|
}, |
||||||
|
} |
||||||
|
: {}), |
||||||
|
}); |
||||||
|
|
||||||
|
function getPaginatedResponseType(type: string) { |
||||||
|
return { |
||||||
|
type: 'object', |
||||||
|
properties: { |
||||||
|
list: { |
||||||
|
type: 'array', |
||||||
|
items: { |
||||||
|
$ref: `#/components/schemas/${type}`, |
||||||
|
}, |
||||||
|
}, |
||||||
|
PageInfo: { |
||||||
|
$ref: `#/components/schemas/Paginated`, |
||||||
|
}, |
||||||
|
}, |
||||||
|
}; |
||||||
|
} |
@ -0,0 +1,109 @@ |
|||||||
|
import { isSystemColumn } from 'nocodb-sdk'; |
||||||
|
import type { SwaggerColumn } from '../getSwaggerColumnMetas'; |
||||||
|
|
||||||
|
export const getModelSchemas = (ctx: { |
||||||
|
tableName: string; |
||||||
|
orgs: string; |
||||||
|
baseName: string; |
||||||
|
columns: Array<SwaggerColumn>; |
||||||
|
}) => ({ |
||||||
|
[`${ctx.tableName}Response`]: { |
||||||
|
title: `${ctx.tableName} Response`, |
||||||
|
type: 'object', |
||||||
|
description: '', |
||||||
|
'x-internal': false, |
||||||
|
properties: { |
||||||
|
...(ctx.columns?.reduce( |
||||||
|
(colsObj, { title, virtual, column, ...fieldProps }) => ({ |
||||||
|
...colsObj, |
||||||
|
...(column.system |
||||||
|
? {} |
||||||
|
: { |
||||||
|
[title]: fieldProps, |
||||||
|
}), |
||||||
|
}), |
||||||
|
{}, |
||||||
|
) || {}), |
||||||
|
}, |
||||||
|
}, |
||||||
|
[`${ctx.tableName}Request`]: { |
||||||
|
title: `${ctx.tableName} Request`, |
||||||
|
type: 'object', |
||||||
|
description: '', |
||||||
|
'x-internal': false, |
||||||
|
properties: { |
||||||
|
...(ctx.columns?.reduce( |
||||||
|
(colsObj, { title, virtual, column, ...fieldProps }) => ({ |
||||||
|
...colsObj, |
||||||
|
...(virtual || isSystemColumn(column) || column.ai || column.meta?.ag |
||||||
|
? {} |
||||||
|
: { |
||||||
|
[title]: fieldProps, |
||||||
|
}), |
||||||
|
}), |
||||||
|
{}, |
||||||
|
) || {}), |
||||||
|
}, |
||||||
|
}, |
||||||
|
[`${ctx.tableName}IdRequest`]: { |
||||||
|
title: `${ctx.tableName} Id Request`, |
||||||
|
type: 'object', |
||||||
|
description: '', |
||||||
|
'x-internal': false, |
||||||
|
properties: { |
||||||
|
...(ctx.columns?.reduce( |
||||||
|
(colsObj, { title, virtual, column, ...fieldProps }) => ({ |
||||||
|
...colsObj, |
||||||
|
...(column.pk |
||||||
|
? { |
||||||
|
[title]: fieldProps, |
||||||
|
} |
||||||
|
: {}), |
||||||
|
}), |
||||||
|
{}, |
||||||
|
) || {}), |
||||||
|
}, |
||||||
|
}, |
||||||
|
}); |
||||||
|
export const getViewSchemas = (ctx: { |
||||||
|
tableName: string; |
||||||
|
viewName: string; |
||||||
|
orgs: string; |
||||||
|
baseName: string; |
||||||
|
columns: Array<SwaggerColumn>; |
||||||
|
}) => ({ |
||||||
|
[`${ctx.tableName}${ctx.viewName}GridResponse`]: { |
||||||
|
title: `${ctx.tableName} : ${ctx.viewName} Response`, |
||||||
|
type: 'object', |
||||||
|
description: '', |
||||||
|
'x-internal': false, |
||||||
|
properties: { |
||||||
|
...(ctx.columns?.reduce( |
||||||
|
(colsObj, { title, virtual, column, ...fieldProps }) => ({ |
||||||
|
...colsObj, |
||||||
|
[title]: fieldProps, |
||||||
|
}), |
||||||
|
{}, |
||||||
|
) || {}), |
||||||
|
}, |
||||||
|
}, |
||||||
|
[`${ctx.tableName}${ctx.viewName}GridRequest`]: { |
||||||
|
title: `${ctx.tableName} : ${ctx.viewName} Request`, |
||||||
|
type: 'object', |
||||||
|
description: '', |
||||||
|
'x-internal': false, |
||||||
|
properties: { |
||||||
|
...(ctx.columns?.reduce( |
||||||
|
(colsObj, { title, virtual, column, ...fieldProps }) => ({ |
||||||
|
...colsObj, |
||||||
|
...(virtual |
||||||
|
? {} |
||||||
|
: { |
||||||
|
[title]: fieldProps, |
||||||
|
}), |
||||||
|
}), |
||||||
|
{}, |
||||||
|
) || {}), |
||||||
|
}, |
||||||
|
}, |
||||||
|
}); |
Loading…
Reference in new issue