GET päring (registrid): erinevus redaktsioonide vahel

Allikas: Excellent || Opendoc
Mine navigeerimisribale Mine otsikasti
(Uus lehekülg: '== GET Registers (standard) == Requests specify the company and resource to read, in the most basic format: <nowiki>http://hostname.domain.top/api/1/IVVc</nowiki> where: * "api...')
 
Resümee puudub
1. rida: 1. rida:
[[Hausing|Hausing - Pealeht]]
== GET Registers (standard) ==
== GET Registers (standard) ==
Requests specify the company and resource to read, in the most basic format:
Requests specify the company and resource to read, in the most basic format:
74. rida: 76. rida:
''Example'':
''Example'':
  <nowiki>http://hostname/api/1/IVVc?offset=0&limit=5</nowiki>
  <nowiki>http://hostname/api/1/IVVc?offset=0&limit=5</nowiki>
   
   
  <nowiki>http://hostname/api/1/IVVc?offset=5&limit=5</nowiki>
  <nowiki>http://hostname/api/1/IVVc?offset=5&limit=5</nowiki>
   
   
  <nowiki>http://hostname/api/1/IVVc?offset=10&limit=5</nowiki>
  <nowiki>http://hostname/api/1/IVVc?offset=10&limit=5</nowiki>

Redaktsioon: 6. august 2018, kell 08:40

Hausing - Pealeht

GET Registers (standard)

Requests specify the company and resource to read, in the most basic format:

http://hostname.domain.top/api/1/IVVc

where:

  • "api" is a mandatory hardcoded string
  • "1" is the company code from the companies setting (1st column)
  • "IVVc" is the name of the register

This would fetch all invoices in company 1.

To retrieve information about base currencies, you similarly use:

http://hostname/api/1/BaseCurBlock

Data Format

The data format for request and returned data is the same and hardcoded.

  • The decimal point is "." (period)
  • There is no thousand separator
  • Dates are in ISO format YYYY-MM-DD

Parameters

The actual parameter values used for results such as key and range used, version of the server etc. are returned as attributes of the data tag.

sort

The sort parameter will sort the retrieved records on the specified field. The name of the index that was used will be returned in the result. Only one field can be sorted on, and only if there is a suitable index, if there is no suitable index the request will fail. The field name is case sensitive.

Example:

http://hostname.domain.top/api/1/IVVc?sort=CustCode

range

Requires the use of the sort parameter.

Retrieve only records where the sorted-on field is inside the specified range. The range is inclusive (values matching the start and end values are inside the range). The first and last value of the range are separated with the ":" (colon character). Open ranges where only the 1st or last value is specified are allowed, and will return all records before or after the specified value. If only a singular value is specified (no colon) only records matching that value will be retrieved.

Examples:

http://hostname.domain.top/api/1/IVVc?sort=CustCode&range=10101:10104

Will return invoices with customers from 10101 to 10104

http://hostname.domain.top/api/1/IVVc?sort=CustCode&range=10104: 

Will return invoices with customers from 10104 until the last customer

http://hostname.domain.top/api/1/IVVc?sort=CustCode&range=10104

Will return invoices only for customer 10104

the range parameter is fast to use because it uses an index.

fields

The fields parameter specifies which fields are to be retrieved. The fields are specified comma separated. If the parameter is not present all fields are retrieved. If a field in the matrix and a field in the header has the same name, both will be retrieved. If no field in the matrix are retrieved then the matrix itself (number of rows etc.) will not be present in the result.

Example:

http://hostname.domain.top/api/1/IVVc?fields=SerNr,OKFlag,Addr0,ArtCode,CustCode,InvDate,TransDate,Objects

filter

The data can be filtered with the filter parameter. it is specified like this:

http://hostname.domain.top/api/1/IVVc?filter.CustCode=10104

The filter is significantly slower than range, as it will not use an index and scan all records. If you use a range the filter will only scan the records in the range, so try to use the most selective condition possible in the range and all other conditions in filters.

  • There can only be one filter per field
  • There can be multiple filters on different fields
  • Filters can handle ranges of values, with the same syntax as range, including open ranges
  • Filters work only on header fields
  • Filtering on list fields such as Objects is done by the whole string. a filter.Objects=AB will not match "AB,D10101"

Example:

http://hostname.domain.top/api/1/IVVc?filter.CustCode=10100:10200&Sum4=100:1000

Will retrieve invoices with a total sum of 100 to 1000 for customers in the range 10100 to 10200.

offset and limit

If the result is larger than the api user can handle in one request, the result can be retrieved in smaller pieces.

The offset will skip the specified number of records before producing output and the limit will restrict the number of records retrieved.

Example:

http://hostname/api/1/IVVc?offset=0&limit=5
 
http://hostname/api/1/IVVc?offset=5&limit=5
 
http://hostname/api/1/IVVc?offset=10&limit=5

will retrieve the 15 first invoices in 3 separate requests.

offset and limit works together will all other parameters

updates_after

returns all records that were updated after a given sequence number.

the sequence number is returned in each request and can be saved for later use with updates_after

Example:

http://hostname/api/1/IVVc?updates_after=5000

deletes_after

returns all record that were deleted after a given sequence number.

the sequence number is returned in each request and can be saved for later use with deletes_after

Example:

http://hostname/api/1/IVVc?deletes_after=5000