Zeta Middleware API
Browser and node module for making API requests against Zeta Middleware API.
Please note: This module uses Popsicle to make API requests. Promises must be supported or polyfilled on all target environments.
Installation
npm install zeta-middleware-api --save
bower install zeta-middleware-api --save
Usage
Node
var ZetaMiddlewareApi = ; var client = ;
Browsers
Options
You can set options when you initialize a client or at any time with the options
property. You may also override options for a single request by passing an object as the second argument of any request method. For example:
var client = ... ; clientoptions = ... ; client;
Base URI
You can override the base URI by setting the baseUri
property, or initializing a client with a base URI. For example:
baseUri: 'https://example.com';
Base URI Parameters
If the base URI has parameters inline, you can set them by updating the baseUriParameters
property. For example:
clientoptionsbaseUriParametersversion = 'v1';
Resources
All methods return a HTTP request instance of Popsicle, which allows the use of promises (and streaming in node).
resources.entities.schema
var resource = clientresourcesentitiesschema;
GET
Este endpoint disponibiliza uma lista completa dos recursos disponíveis nesta instância específica do Middleware, com informações sobre a estrutura de dos recursos, campos, tipos de dados, índices de pesquisa e identificadores.
resource;
Query Parameters
resource;
- extended boolean
Este recurso possui metadados adicionais que pode ser solicitados sob demanda. O parâmetro extended define o modo com que os metadados contidos no recurso em questão serão apresentados. O valor padrão de extended é false, apresentado os metadados em sua representação simples. Para uma representação detalhada o parâmetro deve ser ajustado para true.
resources.entities.schema.name(name)
- name string
Nome do recurso a ser descrito.
var resource = clientresourcesentitiesschemanamename;
GET
Apresenta a estrutura, campos, tipos de dados, índices de pesquisa e identificadores de um único recurso da instância.
resource;
Query Parameters
resource;
- extended boolean
Este recurso possui metadados adicionais que pode ser solicitados sob demanda. O parâmetro extended define o modo com que os metadados contidos no recurso em questão serão apresentados. O valor padrão de extended é false, apresentado os metadados em sua representação simples. Para uma representação detalhada o parâmetro deve ser ajustado para true.
resources.entities.name(name)
- name string
Nome do tipo de recurso sobre o qual a operação será executada. Apenas tipos listados no endpoint /resources/schema serão aceitos.
var resource = clientresourcesentitiesnamename;
GET
Retorna todos os itens de um determinado tipo de recurso. Suporta seleção customizada dos campos das representações padrão dos recursos, ordenação e paginação.
resource;
Query Parameters
resource;
- limit integer, default: 100
Este recurso suporta paginação. O parâmetro limit define o numero máximo de itens retornados por página. Embora não seja obrigatório, pode trabalhar em conjunto com o parâmtro offset. (ex limit=10 retorna uma página de itens da posição 0 até 10. O valor padrão de limit é 100, quando ajustado para 0 desabilita a paginação.
- offset integer
O parâmetro offset, ou deslocamento, indica o número de itens saltados antes do inicio da contagem definida por limit (ex: ?limit=10&offset=10 retorna uma página de itens da posição 11 até 20). O valor padão de offset é 0.
- sort string
Este recurso suporta ordenação. O parâmetro sort define o modo como a lista de itens será ordenada.
- fields string
É possíve retornar apenas um subconunto de campos da prepresentação padrão do recurso quando necessário. Nem sempre o cliente precisa de todas as informações contidas na representação padrão do recurso, permitir que ele receba somente quais informações que realmente precisa permite utilizar melhor recursos importantes como rede e hardware, otimizando a performance e eficiência do cunsumoa do serviço.
POST
Cria um novo recurso.
resource;
Body
application/json
resources.entities.name(name).id(id)
- id string
Identificador único do recurso sobre o qual a operação será executada. Apenas recursos listados no endpoint /resources/schema serão aceitos.
var resource = clientresourcesentitiesnamenameidid;
GET
Retorna um recurso.
resource;
Query Parameters
resource;
- fields string
É possíve retornar apenas um subconunto de campos da prepresentação padrão do recurso quando necessário. Nem sempre o cliente precisa de todas as informações contidas na representação padrão do recurso, permitir que ele receba somente quais informações que realmente precisa permite utilizar melhor recursos importantes como rede e hardware, otimizando a performance e eficiência do cunsumoa do serviço.
DELETE
Destrói um recurso.
resource;
PATCH
Atualiza parcialmente um recurso.
resource;
Body
application/json
PUT
Atualiza um recurso.
resource;
Body
application/json
resources.entities.search
var resource = clientresourcesentitiessearch;
GET
Endpoint que expõe uma interface de consulta nativa, baseada em SQL (ODBC 3.0)
resource;
Query Parameters
resource;
- limit integer, default: 100
Este recurso suporta paginação. O parâmetro limit define o numero máximo de itens retornados por página. Embora não seja obrigatório, pode trabalhar em conjunto com o parâmtro offset. (ex limit=10 retorna uma página de itens da posição 0 até 10. O valor padrão de limit é 100, quando ajustado para 0 desabilita a paginação.
- offset integer
O parâmetro offset, ou deslocamento, indica o número de itens saltados antes do inicio da contagem definida por limit (ex: ?limit=10&offset=10 retorna uma página de itens da posição 11 até 20). O valor padão de offset é 0.
- extended boolean
Este recurso possui metadados adicionais que pode ser solicitados sob demanda. O parâmetro extended define o modo com que os metadados contidos no recurso em questão serão apresentados. O valor padrão de extended é false, apresentado os metadados em sua representação simples. Para uma representação detalhada o parâmetro deve ser ajustado para true.
- q string
Uma declaração de cláusula SELECT da SQL (ODBC 3.0)
resources.health
var resource = clientresourceshealth;
GET
resource;
resources.artifacts
var resource = clientresourcesartifacts;
GET
resource;
Query Parameters
resource;
- sort string
Este recurso suporta ordenação. O parâmetro sort define o modo como a lista de itens será ordenada.
resources.artifacts.name(name)
- name string
var resource = clientresourcesartifactsnamename;
GET
resource;
Custom Resources
You can make requests to a custom path in the API using the #resource(path)
method.
client;
License
Apache 2.0