py4web 1.20201127.1 - en to pt translation catalogue (29 entries)

en: The RESTAPI
pt: A RESTAPI

en: Since version 19.5.10 PyDAL includes a restful API called RestAPI. It is inspired by GraphQL but it’s not quite the same because it is less powerful but, in the spirit of web2py, more practical and easier to use. Like GraphSQL RestAPI allows a client to query for information using the GET method and allows to specify some details about the format of the response (which references to follow, and how to denormalize the data). Unlike GraphSQL it allows the server to specify a policy and restrict which queries are allowed and which one are not. They can be evaluated dynamically per request based on the user and the state of the server. As the name implied RestAPI allows all stardard methods GET, POST, PUT, and DELETE. Each of them can be enabled or disabled based on the policy, for individual tables and individual fields.
pt: Desde a versão 19.5.10 PyDAL inclui uma API RESTful chamado RestAPI. É inspirado por GraphQL mas não é bem a mesma coisa, porque é menos poderoso, mas, no espírito do web2py, mais prático e mais fácil de usar. Como GraphSQL RestAPI permite que um cliente para consulta de informações usando o método GET e permite especificar alguns detalhes sobre o formato da resposta (que referências a seguir, e como desnormalizar os dados). Ao contrário GraphSQL ele permite que o servidor para especificar uma política e restringir quais consultas são permitidas e quais não são. Eles podem ser avaliados de forma dinâmica por solicitação com base no usuário e o estado do servidor. Como o nome implica RestAPI permite que todos os métodos stardard GET, POST, PUT e DELETE. Cada um deles pode ser ativado ou desativado com base na política, para tabelas individuais e campos individuais.

en: In the examples below we assume an app called “superheroes” and the following model:
pt: Nos exemplos abaixo assumimos um aplicativo chamado “super-heróis” e o seguinte modelo:

en: We also assume the following controller ``rest.py``:
pt: Também assumimos o seguinte controlador `` rest.py``:

en: The policy is per table (or \* for all tables and per method. authorize can be True (allow), False (deny) or a function with the signature (method, tablename, record_id, get_vars, post_vars) which returns True/False. For the GET policy one can specify a list of allowed query patterns (\* for all). A query pattern will be matched against the keys in the query string.
pt: A política é por tabela (ou \ * para todas as tabelas e por método. Autorizar pode ser verdade (permitir), False (negar) ou uma função com a assinatura (método, tablename, record_id, get_vars, post_vars) que retorna Verdadeiro / Falso . para a política GET pode especificar uma lista de padrões de consulta permitidos (\ * para todos). um padrão de consulta será comparado com as chaves na cadeia de consulta.

en: The above action is exposed as:
pt: A acção acima referida é exposto como:

en: The general query has the form ``{something}.eq=value`` where ``eq=`` stands for “equal”, ``gt=`` stands for “greater than”, etc. The expression can be prepended by ``not.``.
pt: A consulta geral tem a forma `` {} algo .eq = value`` onde `` eq = `` significa “igual”, `` gt = `` significa “maior que”, etc. A expressão pode ser prefixado por `` not.``.

en: ``{something}`` can be the name of a field in the table been queried as in:
pt: `` {Algo} `` pode ser o nome de um campo na tabela foi consultado como em:

en: **All superheroes called “Superman”**
pt: ** Todos os super-heróis chamado de “Superman” **

en: It can be a the name of a field of a table referred by the table been queried as in:
pt: Pode ser um nome de um campo de uma tabela referida pela tabela foi consultado como em:

en: **All superheroes with real identity “Clark Kent”**
pt: ** Todos os super-heróis com a identidade real “Clark Kent” **

en: It can be the name of a field of a table that refers to the table neen queried as in:
pt: Pode ser o nome de um campo de uma tabela que se refere ao neen tabela consultada como em:

en: **All superheroes with any tag superpower with strength > 90**
pt: ** Todos os super-heróis com qualquer superpotência tag com força> 90 **

en: (here tag is the name of the link table, the preceding ``superhero`` is the name of the field that refers to the selected table and ``strength`` is the name of the field used to filter)
pt: (Aqui tag é o nome da tabela de ligação, o anterior `` superhero`` é o nome do campo que faz referência ao quadro seleccionado e `` strength`` é o nome do campo utilizado para filtro)

en: It can also be a field of the table referenced by a many-to-many linked table as in:
pt: Ele também pode ser um campo da tabela referenciada por uma tabela de muitos-para-muitos ligado como em:

en: **All superheroes with the flight power**
pt: ** Todos os super-heróis com o poder de vôo **

en: The key to understand the syntax above is to break it as follows:
pt: A chave para entender a sintaxe acima é para quebrá-lo da seguinte forma:

en: and read it as:
pt: e lê-lo como:

en: select records of table **superhero** referred by field **superhero** of table **tag** when the **superpower** field of said table points to a record with **description** **eq**\ ual to “Flight”.
pt: selecionar registros da tabela ** super-herói ** referido pelo campo ** super-herói ** da tabela ** tag ** quando a superpotência ** ** campo dos ditos pontos de mesa para um recorde com a descrição ** ** ** ** eq \ ual para “Flight”.

en: The query allows additional modifiers for example
pt: A consulta permite modificadores adicionais, por exemplo

en: The first 3 are obvious. @model returns a JSON description of database model. Lookup denormalizes the linked field.
pt: Os 3 primeiros são óbvias. @model retorna uma descrição JSON do modelo de banco de dados. Lookup desnormaliza o campo vinculado.

en: Here are some practical examples:
pt: Aqui estão alguns exemplos práticos:

en: OUTPUT:
pt: RESULTADO:

en: (denormalize the real_identity and rename it identity)
pt: (Desnormalizar o real_identity e renomeá-lo de identidade)

en: (denormalize the real_identity [but only fields name and job], collapse the with the identity prefix)
pt: (Desnormalizar o real_identity [mas apenas campos nome e trabalho], recolher a com o prefixo de identidade)

en: URL (it's a single line, splitted for readability):
pt: URL (que é uma linha única, dividida para facilitar a leitura):

en: Notice all RestAPI response have the fields
pt: Note todas resposta RestAPI ter os campos

en: and some optional fields:
pt: e alguns campos opcionais:

en: The exact specs are subject to change since this is a new feature.
pt: As especificações exatas estão sujeitos a mudança uma vez que este é um novo recurso.
