Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

      • product: produto ao qual aquelas informações do "productInformation" se referem;
      • contact: e-mail para contato com quem desenvolveu aquela API naquele determinado produto;
      • description: descrição da API para aquele determinado produto;
      • adapter: adapter que se comunica com aquela determinada API;
      • A propriedade "productInformation" poderia ter ainda a tag helpUrl, que contém um link para a documentação daquela API para aquele produto, caso haja.
    Nota
    titleSegment e Product padronizados

    A grafia dos campos 'segment' e 'product' descritos acima devem estar de acordo com padrões previamente determinados. Para saber qual a grafia correta do segmento e produto que deseja declarar, visite a lista de referências do portal de APIs e verifique no menu lateral os padrões de grafia aceitos.


  • x-totvs dentro dos verbos dos endpoints 
    Âncora
    xtotvs-paths
    xtotvs-paths

    O exemplo a seguir também é um trecho da API UnitOfMeasure v2.

    Bloco de código
    languagejs
    titleExemplo
    collapsetrue
    (...)
    "paths": {
    		"/UnitOfMeasures": {
    			"get": {
    				"tags": [
    					"UnitOfMeasures"
    				],
    				"summary": "Retorna lista de Unidade de Medida",
    				"x-totvs": {
    					"productInformation": [
    						{
    							"product": "Protheus",
    							"available": true,
    							"note": "Este verbo esta disponivel com todos os parametros",
    							"minimalVersion": "12.1.21"
    						},
    						{
    							"product": "Logix",
    							"available": true,
    							"note": "Este verbo esta disponivel com todos os parametros",
    							"minimalVersion": "12.1.23"
    						}
    					]
    				}
    (...)

    Diferentemente do x-totvs da "info",  a propriedade "messageDocumentation" não está presente nos x-totvs dos "paths".

    Já a propriedade "productInformation" traz informações sobre os produtos TOTVS.

    • product: produto ao qual aquelas informações do "productInformation" se referem;
    • available: campo booleano que indicia de o verbo esta implementado no produto;
    • note: observações sobre o verbo referente ao produto, como regras específicas;
    • minimalVersion: a versão minima na qual o verbo foi implementado no produto.

...