Working on api docs

This commit is contained in:
David Bomba 2023-02-12 15:11:39 +11:00
parent 7878cf9e24
commit a8d8911335
4 changed files with 134 additions and 74 deletions

View File

@ -27,7 +27,7 @@ paths:
get: get:
tags: tags:
- actvities - actvities
summary: 'Gets a list of actvities' summary: 'Returns a list of actvities'
description: 'Lists all activities related to this company' description: 'Lists all activities related to this company'
operationId: getActivities operationId: getActivities
parameters: parameters:
@ -67,8 +67,8 @@ paths:
get: get:
tags: tags:
- actvities - actvities
summary: 'Gets a PDF for the given activity' summary: 'Returns a PDF for the given activity'
description: 'Gets a PDF for the given activity' description: 'Returns a PDF for the given activity'
operationId: getActivityHistoricalEntityPdf operationId: getActivityHistoricalEntityPdf
parameters: parameters:
- -
@ -172,10 +172,22 @@ paths:
post: post:
tags: tags:
- refresh - refresh
summary: 'Refreshes the dataset' summary: 'Refresh data by timestamp'
description: 'Refreshes the dataset' description: |
operationId: refresh Refreshes the dataset.
This endpoint can be used if you only need to access the most recent data from a certain point in time.
operationId: refresh
parameters: parameters:
-
name: updated_at
in: query
description: 'The unix timestamp from which the refreshed data should be sent from, if no value is passed the system will assume you require all data.'
required: true
schema:
type: number
format: integer
example: 1676173763
- -
$ref: '#/components/parameters/X-API-TOKEN' $ref: '#/components/parameters/X-API-TOKEN'
- -
@ -200,12 +212,6 @@ paths:
application/json: application/json:
schema: schema:
$ref: '#/components/schemas/CompanyUser' $ref: '#/components/schemas/CompanyUser'
422:
description: 'Validation error'
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationError'
default: default:
description: 'Unexpected Error' description: 'Unexpected Error'
content: content:
@ -216,16 +222,14 @@ paths:
post: post:
tags: tags:
- yodlee - yodlee
summary: 'Processing webhooks from Yodlee' summary: 'Yodlee Webhook'
description: 'Notifies the system when a data point can be refreshed' description: 'Webhook endpoint for Yodlee. Used to notify the system that a data point can be updated.'
operationId: yodleeRefreshWebhook operationId: yodleeRefreshWebhook
parameters: parameters:
- -
$ref: '#/components/parameters/X-API-TOKEN' $ref: '#/components/parameters/X-API-TOKEN'
- -
$ref: '#/components/parameters/X-Requested-With' $ref: '#/components/parameters/X-Requested-With'
-
$ref: '#/components/parameters/include'
responses: responses:
200: 200:
description: '' description: ''
@ -240,12 +244,6 @@ paths:
application/json: application/json:
schema: schema:
$ref: '#/components/schemas/Credit' $ref: '#/components/schemas/Credit'
422:
description: 'Validation error'
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationError'
default: default:
description: 'Unexpected Error' description: 'Unexpected Error'
content: content:
@ -256,7 +254,7 @@ paths:
get: get:
tags: tags:
- bank_integrations - bank_integrations
summary: 'Gets a list of bank_integrations' summary: 'Returns a list of Bank Integrations'
description: 'Lists all bank integrations' description: 'Lists all bank integrations'
operationId: getBankIntegrations operationId: getBankIntegrations
parameters: parameters:
@ -265,7 +263,7 @@ paths:
- -
$ref: '#/components/parameters/X-Requested-With' $ref: '#/components/parameters/X-Requested-With'
- -
$ref: '#/components/parameters/include' $ref: '#/components/parameters/bank_integration_include'
- -
$ref: '#/components/parameters/index' $ref: '#/components/parameters/index'
- -
@ -1571,8 +1569,11 @@ paths:
get: get:
tags: tags:
- clients - clients
summary: 'Gets a list of clients' summary: 'List clients'
description: "Lists clients, search and filters allow fine grained lists to be generated.\n\n * Query parameters can be added to performed more fine grained filtering of the clients, these are handled by the ClientFilters class which defines the methods available" description: |
Lists clients, search and filters allow fine grained lists to be generated.
Query parameters can be added to performed more fine grained filtering of the clients, these are handled by the ClientFilters class which defines the methods available
operationId: getClients operationId: getClients
parameters: parameters:
- -
@ -1612,7 +1613,7 @@ paths:
post: post:
tags: tags:
- clients - clients
summary: 'Adds a client' summary: 'Create client'
description: 'Adds an client to a company' description: 'Adds an client to a company'
operationId: storeClient operationId: storeClient
parameters: parameters:
@ -1652,7 +1653,7 @@ paths:
get: get:
tags: tags:
- clients - clients
summary: 'Shows a client' summary: 'Show client'
description: 'Displays a client by id' description: 'Displays a client by id'
operationId: showClient operationId: showClient
parameters: parameters:
@ -1700,7 +1701,7 @@ paths:
put: put:
tags: tags:
- clients - clients
summary: 'Updates a client' summary: 'Update client'
description: 'Handles the updating of a client by id' description: 'Handles the updating of a client by id'
operationId: updateClient operationId: updateClient
parameters: parameters:
@ -1748,7 +1749,7 @@ paths:
delete: delete:
tags: tags:
- clients - clients
summary: 'Deletes a client' summary: 'Delete client'
description: 'Handles the deletion of a client by id' description: 'Handles the deletion of a client by id'
operationId: deleteClient operationId: deleteClient
parameters: parameters:
@ -1793,7 +1794,7 @@ paths:
get: get:
tags: tags:
- clients - clients
summary: 'Shows a client for editting' summary: 'Edit Client'
description: 'Displays a client by id' description: 'Displays a client by id'
operationId: editClient operationId: editClient
parameters: parameters:
@ -1842,7 +1843,7 @@ paths:
get: get:
tags: tags:
- clients - clients
summary: 'Gets a new blank client object' summary: 'Blank Client'
description: 'Returns a blank object with default values' description: 'Returns a blank object with default values'
operationId: getClientsCreate operationId: getClientsCreate
parameters: parameters:
@ -1882,7 +1883,7 @@ paths:
post: post:
tags: tags:
- clients - clients
summary: 'Performs bulk actions on an array of clients' summary: 'Client Bulk Actions'
description: '' description: ''
operationId: bulkClients operationId: bulkClients
parameters: parameters:
@ -1933,7 +1934,7 @@ paths:
put: put:
tags: tags:
- clients - clients
summary: 'Uploads a document to a client' summary: 'Client Upload'
description: 'Handles the uploading of a document to a client' description: 'Handles the uploading of a document to a client'
operationId: uploadClient operationId: uploadClient
parameters: parameters:
@ -1982,7 +1983,7 @@ paths:
post: post:
tags: tags:
- clients - clients
summary: 'Purges a client from the system' summary: 'Purge client'
description: 'Handles purging a client' description: 'Handles purging a client'
operationId: purgeClient operationId: purgeClient
parameters: parameters:
@ -2027,7 +2028,7 @@ paths:
post: post:
tags: tags:
- clients - clients
summary: 'Merges two clients' summary: 'Merge client'
description: 'Handles merging 2 clients' description: 'Handles merging 2 clients'
operationId: mergeClient operationId: mergeClient
parameters: parameters:
@ -2081,7 +2082,7 @@ paths:
get: get:
tags: tags:
- client_gateway_tokens - client_gateway_tokens
summary: 'Gets a list of client_gateway_tokens' summary: 'List of client tokens'
description: "Lists client_gateway_tokens, search and filters allow fine grained lists to be generated.\n\n Query parameters can be added to performed more fine grained filtering of the client_gateway_tokens, these are handled by the ClientGatewayTokenFilters class which defines the methods available" description: "Lists client_gateway_tokens, search and filters allow fine grained lists to be generated.\n\n Query parameters can be added to performed more fine grained filtering of the client_gateway_tokens, these are handled by the ClientGatewayTokenFilters class which defines the methods available"
operationId: getClientGatewayTokens operationId: getClientGatewayTokens
parameters: parameters:
@ -18955,6 +18956,23 @@ components:
schema: schema:
type: string type: string
example: supersecretpassword example: supersecretpassword
bank_integration_include:
name: include
in: query
description: Include child relations of the BankIntegration object. Format is comma separated.
require: false
schema:
type: string
examples:
company:
value: company
summary: The associated Company
account:
value: account
summary: The associated Account
bank_transactions:
value: bank_transactions
summary: The associated Bank Transactions
activity_include: activity_include:
name: include name: include
in: query in: query
@ -19105,6 +19123,18 @@ tags:
externalDocs: externalDocs:
description: 'Find out more' description: 'Find out more'
url: 'https://invoiceninja.github.io' url: 'https://invoiceninja.github.io'
-
name: clients
description: |
Endpoint definitions for interacting with clients.
-
name: products
description: |
Endpoint definitions for interacting with products.
-
name: invoices
description: |
Endpoint definitions for interacting with invoices.
externalDocs: externalDocs:
description: 'https://invoiceninja.github.io' description: 'https://invoiceninja.github.io'
url: 'https://invoiceninja.github.io' url: 'https://invoiceninja.github.io'

View File

@ -4084,6 +4084,23 @@ components:
schema: schema:
type: string type: string
example: supersecretpassword example: supersecretpassword
bank_integration_include:
name: include
in: query
description: Include child relations of the BankIntegration object. Format is comma separated.
require: false
schema:
type: string
examples:
company:
value: company
summary: The associated Company
account:
value: account
summary: The associated Account
bank_transactions:
value: bank_transactions
summary: The associated Bank Transactions
activity_include: activity_include:
name: include name: include
in: query in: query

View File

@ -6,6 +6,18 @@ tags:
externalDocs: externalDocs:
description: 'Find out more' description: 'Find out more'
url: 'https://invoiceninja.github.io' url: 'https://invoiceninja.github.io'
-
name: clients
description: |
Endpoint definitions for interacting with clients.
-
name: products
description: |
Endpoint definitions for interacting with products.
-
name: invoices
description: |
Endpoint definitions for interacting with invoices.
externalDocs: externalDocs:
description: 'https://invoiceninja.github.io' description: 'https://invoiceninja.github.io'
url: 'https://invoiceninja.github.io' url: 'https://invoiceninja.github.io'

View File

@ -3,7 +3,7 @@ paths:
get: get:
tags: tags:
- actvities - actvities
summary: 'Gets a list of actvities' summary: 'Returns a list of actvities'
description: 'Lists all activities related to this company' description: 'Lists all activities related to this company'
operationId: getActivities operationId: getActivities
parameters: parameters:
@ -43,8 +43,8 @@ paths:
get: get:
tags: tags:
- actvities - actvities
summary: 'Gets a PDF for the given activity' summary: 'Returns a PDF for the given activity'
description: 'Gets a PDF for the given activity' description: 'Returns a PDF for the given activity'
operationId: getActivityHistoricalEntityPdf operationId: getActivityHistoricalEntityPdf
parameters: parameters:
- -
@ -148,10 +148,22 @@ paths:
post: post:
tags: tags:
- refresh - refresh
summary: 'Refreshes the dataset' summary: 'Refresh data by timestamp'
description: 'Refreshes the dataset' description: |
operationId: refresh Refreshes the dataset.
This endpoint can be used if you only need to access the most recent data from a certain point in time.
operationId: refresh
parameters: parameters:
-
name: updated_at
in: query
description: 'The unix timestamp from which the refreshed data should be sent from, if no value is passed the system will assume you require all data.'
required: true
schema:
type: number
format: integer
example: 1676173763
- -
$ref: '#/components/parameters/X-API-TOKEN' $ref: '#/components/parameters/X-API-TOKEN'
- -
@ -176,12 +188,6 @@ paths:
application/json: application/json:
schema: schema:
$ref: '#/components/schemas/CompanyUser' $ref: '#/components/schemas/CompanyUser'
422:
description: 'Validation error'
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationError'
default: default:
description: 'Unexpected Error' description: 'Unexpected Error'
content: content:
@ -192,16 +198,14 @@ paths:
post: post:
tags: tags:
- yodlee - yodlee
summary: 'Processing webhooks from Yodlee' summary: 'Yodlee Webhook'
description: 'Notifies the system when a data point can be refreshed' description: 'Webhook endpoint for Yodlee. Used to notify the system that a data point can be updated.'
operationId: yodleeRefreshWebhook operationId: yodleeRefreshWebhook
parameters: parameters:
- -
$ref: '#/components/parameters/X-API-TOKEN' $ref: '#/components/parameters/X-API-TOKEN'
- -
$ref: '#/components/parameters/X-Requested-With' $ref: '#/components/parameters/X-Requested-With'
-
$ref: '#/components/parameters/include'
responses: responses:
200: 200:
description: '' description: ''
@ -216,12 +220,6 @@ paths:
application/json: application/json:
schema: schema:
$ref: '#/components/schemas/Credit' $ref: '#/components/schemas/Credit'
422:
description: 'Validation error'
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationError'
default: default:
description: 'Unexpected Error' description: 'Unexpected Error'
content: content:
@ -232,7 +230,7 @@ paths:
get: get:
tags: tags:
- bank_integrations - bank_integrations
summary: 'Gets a list of bank_integrations' summary: 'Returns a list of Bank Integrations'
description: 'Lists all bank integrations' description: 'Lists all bank integrations'
operationId: getBankIntegrations operationId: getBankIntegrations
parameters: parameters:
@ -241,7 +239,7 @@ paths:
- -
$ref: '#/components/parameters/X-Requested-With' $ref: '#/components/parameters/X-Requested-With'
- -
$ref: '#/components/parameters/include' $ref: '#/components/parameters/bank_integration_include'
- -
$ref: '#/components/parameters/index' $ref: '#/components/parameters/index'
- -
@ -1547,8 +1545,11 @@ paths:
get: get:
tags: tags:
- clients - clients
summary: 'Gets a list of clients' summary: 'List clients'
description: "Lists clients, search and filters allow fine grained lists to be generated.\n\n * Query parameters can be added to performed more fine grained filtering of the clients, these are handled by the ClientFilters class which defines the methods available" description: |
Lists clients, search and filters allow fine grained lists to be generated.
Query parameters can be added to performed more fine grained filtering of the clients, these are handled by the ClientFilters class which defines the methods available
operationId: getClients operationId: getClients
parameters: parameters:
- -
@ -1588,7 +1589,7 @@ paths:
post: post:
tags: tags:
- clients - clients
summary: 'Adds a client' summary: 'Create client'
description: 'Adds an client to a company' description: 'Adds an client to a company'
operationId: storeClient operationId: storeClient
parameters: parameters:
@ -1628,7 +1629,7 @@ paths:
get: get:
tags: tags:
- clients - clients
summary: 'Shows a client' summary: 'Show client'
description: 'Displays a client by id' description: 'Displays a client by id'
operationId: showClient operationId: showClient
parameters: parameters:
@ -1676,7 +1677,7 @@ paths:
put: put:
tags: tags:
- clients - clients
summary: 'Updates a client' summary: 'Update client'
description: 'Handles the updating of a client by id' description: 'Handles the updating of a client by id'
operationId: updateClient operationId: updateClient
parameters: parameters:
@ -1724,7 +1725,7 @@ paths:
delete: delete:
tags: tags:
- clients - clients
summary: 'Deletes a client' summary: 'Delete client'
description: 'Handles the deletion of a client by id' description: 'Handles the deletion of a client by id'
operationId: deleteClient operationId: deleteClient
parameters: parameters:
@ -1769,7 +1770,7 @@ paths:
get: get:
tags: tags:
- clients - clients
summary: 'Shows a client for editting' summary: 'Edit Client'
description: 'Displays a client by id' description: 'Displays a client by id'
operationId: editClient operationId: editClient
parameters: parameters:
@ -1818,7 +1819,7 @@ paths:
get: get:
tags: tags:
- clients - clients
summary: 'Gets a new blank client object' summary: 'Blank Client'
description: 'Returns a blank object with default values' description: 'Returns a blank object with default values'
operationId: getClientsCreate operationId: getClientsCreate
parameters: parameters:
@ -1858,7 +1859,7 @@ paths:
post: post:
tags: tags:
- clients - clients
summary: 'Performs bulk actions on an array of clients' summary: 'Client Bulk Actions'
description: '' description: ''
operationId: bulkClients operationId: bulkClients
parameters: parameters:
@ -1909,7 +1910,7 @@ paths:
put: put:
tags: tags:
- clients - clients
summary: 'Uploads a document to a client' summary: 'Client Upload'
description: 'Handles the uploading of a document to a client' description: 'Handles the uploading of a document to a client'
operationId: uploadClient operationId: uploadClient
parameters: parameters:
@ -1958,7 +1959,7 @@ paths:
post: post:
tags: tags:
- clients - clients
summary: 'Purges a client from the system' summary: 'Purge client'
description: 'Handles purging a client' description: 'Handles purging a client'
operationId: purgeClient operationId: purgeClient
parameters: parameters:
@ -2003,7 +2004,7 @@ paths:
post: post:
tags: tags:
- clients - clients
summary: 'Merges two clients' summary: 'Merge client'
description: 'Handles merging 2 clients' description: 'Handles merging 2 clients'
operationId: mergeClient operationId: mergeClient
parameters: parameters:
@ -2057,7 +2058,7 @@ paths:
get: get:
tags: tags:
- client_gateway_tokens - client_gateway_tokens
summary: 'Gets a list of client_gateway_tokens' summary: 'List of client tokens'
description: "Lists client_gateway_tokens, search and filters allow fine grained lists to be generated.\n\n Query parameters can be added to performed more fine grained filtering of the client_gateway_tokens, these are handled by the ClientGatewayTokenFilters class which defines the methods available" description: "Lists client_gateway_tokens, search and filters allow fine grained lists to be generated.\n\n Query parameters can be added to performed more fine grained filtering of the client_gateway_tokens, these are handled by the ClientGatewayTokenFilters class which defines the methods available"
operationId: getClientGatewayTokens operationId: getClientGatewayTokens
parameters: parameters: