open-project-flutter-api/doc/DocumentsApi.md
2023-11-05 19:54:17 +01:00

3.6 KiB

openapi.api.DocumentsApi

Load the API package

import 'package:openapi/api.dart';

All URIs are relative to https://community.openproject.org

Method HTTP request Description
listDocuments GET /api/v3/documents List Documents
viewDocument GET /api/v3/documents/{id} View document

listDocuments

Object listDocuments(offset, pageSize, sortBy)

List Documents

The documents returned depend on the provided parameters and also on the requesting user's permissions.

Example

import 'package:openapi/api.dart';
// TODO Configure HTTP basic authorization: BasicAuth
//defaultApiClient.getAuthentication<HttpBasicAuth>('BasicAuth').username = 'YOUR_USERNAME'
//defaultApiClient.getAuthentication<HttpBasicAuth>('BasicAuth').password = 'YOUR_PASSWORD';

final api_instance = DocumentsApi();
final offset = 25; // int | Page number inside the requested collection.
final pageSize = 25; // int | Number of elements to display per page.
final sortBy = [["created_at", "asc"]]; // String | JSON specifying sort criteria. Accepts the same format as returned by the [queries](https://www.openproject.org/docs/api/endpoints/queries/) endpoint. Currently supported sorts are:  + id: Sort by primary key  + created_at: Sort by document creation datetime

try {
    final result = api_instance.listDocuments(offset, pageSize, sortBy);
    print(result);
} catch (e) {
    print('Exception when calling DocumentsApi->listDocuments: $e\n');
}

Parameters

Name Type Description Notes
offset int Page number inside the requested collection. [optional] [default to 1]
pageSize int Number of elements to display per page. [optional]
sortBy String JSON specifying sort criteria. Accepts the same format as returned by the queries endpoint. Currently supported sorts are: + id: Sort by primary key + created_at: Sort by document creation datetime [optional]

Return type

Object

Authorization

BasicAuth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/hal+json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

viewDocument

DocumentModel viewDocument(id)

View document

Example

import 'package:openapi/api.dart';
// TODO Configure HTTP basic authorization: BasicAuth
//defaultApiClient.getAuthentication<HttpBasicAuth>('BasicAuth').username = 'YOUR_USERNAME'
//defaultApiClient.getAuthentication<HttpBasicAuth>('BasicAuth').password = 'YOUR_PASSWORD';

final api_instance = DocumentsApi();
final id = 1; // int | Document id

try {
    final result = api_instance.viewDocument(id);
    print(result);
} catch (e) {
    print('Exception when calling DocumentsApi->viewDocument: $e\n');
}

Parameters

Name Type Description Notes
id int Document id

Return type

DocumentModel

Authorization

BasicAuth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/hal+json

[Back to top] [Back to API list] [Back to Model list] [Back to README]