ovh-uxng-ovh-api-wrappers
AngularJS component designed to configure Api Endpoints with the same interface as a $resource yet allow for extended configuration by providing ApiRequests objects that can be modified with chained methods to define the headers to Iceberg.
Install
$ yarn add @ovh-ux/ng-ovh-api-wrappersUsage
// index.js
import angular from 'angular';
import ngOvhApiWrappers from '@ovh-ux/ng-ovh-api-wrappers';
angular.module('myApp', [ngOvhApiWrappers]);Iceberg
Simple request
// service.js
function getElements() {
return iceberg('/api/elements')
.query()
.execute({ ...queryParams }, resetCache)
.$promise;
}Response is formatted like
{
data // data returned by the API
headers // response headers returned
status // call status
}Enable aggregation
// service.js
function getAggregatedElements() {
return iceberg('/api/elements')
.query()
.expand(aggregationMode)
.execute();
}aggregationMode can be one of those values:
CachedObjectList-CursorCachedObjectList-Pages
Paginate
// service.js
function getPaginatedElements() {
return iceberg('/api/elements')
.query()
.expand('CachedObjectList-Pages')
.limit(10) // get only 10 results by page
.offset(2) // get results for page 2
.execute();
}Filter
// service.js
function getFilteredElements() {
return iceberg('/api/elements')
.query()
.expand('CachedObjectList-Pages')
.addFilter('name', 'like', 'iceberg') // get element with name matching iceberg
.execute();
}// service.js
function getFilteredElements() {
return iceberg('/api/elements')
.query()
.expand('CachedObjectList-Pages')
.addFilter('name', 'like', ['iceberg', 'awesome']) // get element with name matching iceberg and awesome
.execute();
}Sort
// service.js
function getSortedElements() {
return iceberg('/api/elements')
.query()
.expand('CachedObjectList-Pages')
.sort('name') // sort elements by ascending names
.execute();
}// service.js
function getAggregatedElements() {
return iceberg('/api/elements')
.query()
.expand('CachedObjectList-Pages')
.sort('name', 'desc') // sort elements by descending names
.execute();
}Test
$ yarn testRelated
- ovh-api-services - Contains all AngularJS $resource for OVHcloud API
Contributing
Always feel free to help out! Whether it's filing bugs and feature requests or working on some of the open issues, our contributing guide will help get you started.
License
BSD-3-Clause © OVH SAS