> ## Documentation Index
> Fetch the complete documentation index at: https://doc.allcomtelecom.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Busca informações e erros do serviço

> Autenticação: Token Bearer

Limitação de taxa: sim (grupo INFO de métodos)   

Autorização: Conta de usuário



## OpenAPI

````yaml GET /api/v{version}/info/service
openapi: 3.0.1
info:
  title: OpenAPI Auth Store
  description: API de exemplo para demonstração de autenticação e obtenção de tokens.
  license:
    name: Allcom Telecom
  version: 1.0.0
servers:
  - url: >-
      https://apicorp.algartelecom.com.br/telecom/product-Inventory-management/management/v1
security: []
paths:
  /api/v{version}/info/service:
    get:
      tags:
        - Info
      summary: >-
        Retorna informações do serviço web (versão, lista de códigos de erro,
        ...) (Autenticação)
      description: "Autenticação: Token Bearer\r\n\r\nLimitação de taxa: sim (grupo INFO de métodos)   \r\n\r\nAutorização: Conta de usuário"
      parameters:
        - name: GetErrorCodes
          in: query
          description: >-
            Se 'true', o serviço web também retornará uma lista de códigos de
            erro disponíveis.
          schema:
            type: boolean
        - name: version
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: >-
            Chamada realizada com sucesso. Verifique o ErrorID para possíveis
            erros
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetServiceInfoResponse'
              example:
                Version: 1.0.0.0
                ErrorCodes:
                  - ID: 17149
                    Name: ERR_TERMINAL_BEAM_UNKNOWN
                    Description: Feixe do terminal desconhecido
                  - ID: 17685
                    Name: ERR_MESSAGE_CANNOT_BE_CANCELLED_BECAUSE_ALREADY_SENT
                    Description: >-
                      Mensagem não pode ser cancelada porque já foi enviada ao
                      destino.
                  - ID: 21785
                    Name: ERR_AUTHENTICATION_ERROR
                    Description: Erro de autenticação do serviço Gateway.
        '401':
          description: Quando falha a autenticação e autorização
          content:
            application/json:
              example: Quando falha a autenticação e autorização
        '429':
          description: >-
            Quando o usuário ultrapassa o limite provisionado de requisições
            para o endpoint da API, será retornado o código HTTP 429 “Muitas
            Requisições”
          content:
            application/json:
              example: >-
                Quando o usuário ultrapassa o limite provisionado de requisições
                para o endpoint da API, será retornado o código HTTP 429 “Muitas
                Requisições”
components:
  schemas:
    GetServiceInfoResponse:
      description: >-
        Resposta 'accountinfo/service' - inclui a versão da API e lista de
        códigos de erro.
      properties:
        ErrorID:
          description: >-
            Presente somente em caso de falha. O valor ErrorID serve como
            referência para entender a causa do erro.
          example: 0
        Version:
          description: Número da versão do serviço web (não confundir com a versão da API).
          example: 5.1.8
        ServerUTC:
          description: Hora atual do servidor OGWS.
        ErrorCodes:
          description: >-
            Array de possíveis informações de erro da API. O campo será
            fornecido somente se ‘getErrorCodes’ estiver definido como true.

````