47 lines
1.3 KiB
Markdown
47 lines
1.3 KiB
Markdown
# ETA API
|
|
|
|
ETA Viaporte API
|
|
|
|
# Dependencies
|
|
|
|
- NodeJS v18
|
|
- Docker
|
|
|
|
# Endpoints
|
|
|
|
All endpoints that return a list of elements is paginable with the following queries:
|
|
- `elements`: Number of elements for each page.
|
|
- `page`: Page number (from 0 to n)
|
|
|
|
Example:
|
|
- `/endpoint?elements=50&page=2` : Get page 2 with 50 elements per page.
|
|
- `/endpoint?page=2` : Get page 2 with default (10) elements per page.
|
|
- `/endpoint?elements=50` : Get page 0 with 50 elements.
|
|
|
|
## Public endpoints
|
|
|
|
Read registered resources:
|
|
|
|
- `GET /countries`: List registered countries.
|
|
- `GET /cities`: List registered cities.
|
|
- `GET /meta-data`: List registered meta-data.
|
|
- `GET /meta-groups`: List registered meta-data.
|
|
- `GET /product-categories`: List registered product-categories.
|
|
- `GET /states`: List registered states.
|
|
|
|
All these endpoints support the following parameters:
|
|
|
|
- `/` : List registered resources with pagination.
|
|
- `/:id` : Read specific resource identified by Id.
|
|
- `/find?regex=xxx` : List resources that matches with regex (support pagination).
|
|
|
|
## Private Endpoints
|
|
|
|
The following list of endpoints requires a JWT.
|
|
|
|
## Test Endpoint
|
|
|
|
A private endpoint to test the JWT and the api response.
|
|
|
|
- `POST /apitest`: Return whatever is sent on the body, queries and parameters.
|
|
- `GET /version`: Return the API version. |