> ## 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.

# Lista terminais atualizados desde um horário

> Autenticação: Token Bearer

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

Autorização: Conta de usuário

Os registros retornados são ordenados pela data/hora de atualização do terminal (Update UTC).



## OpenAPI

````yaml GET /api/v{version}/info/terminal_updates
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/terminal_updates:
    get:
      tags:
        - Info
      summary: >-
        Recupera uma lista de informações dos terminais pertencentes à conta do
        chamador. Somente registros atualizados após FromUTC serão retornados.
        (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\r\n\r\nOs registros retornados são ordenados pela data/hora de atualização do terminal (Update UTC)."
      parameters:
        - name: FromUTC
          in: query
          description: >-
            Recupera registros de terminais atualizados após FromUTC. O formato
            do 'FromUTC' é: 'yyyy-MM-dd HH24:mm:ss'
          schema:
            type: string
        - 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/GetTerminalInfoUpdatesResponse'
              example:
                NextFromUTC: '2023-11-22 21:10:14'
                Terminals:
                  - PrimeID: 01095071SKY7658
                    Description: OG-ISAT(Desk#2 - 01095071)
                    LastRegionName: AMERRB15
                    MTSN: 01095071SKY7658
                    LastRegistrationUTC: '2015-11-10 14:59:29'
                    LastRegistrationMessageID: 784365876344
                    LastSatelliteNetwork: 0
                    UpdateUTC: '2023-10-10 14:59:29'
                  - PrimeID: '359739077429074'
                    Description: Terminal de teste modo dual
                    IMEI: '359739077429074'
                    LastRegistrationUTC: '2015-11-10 14:59:29'
                    LastRegistrationMessageID: 784365876343
                    LastSatelliteNetwork: 0
                    PairedTerminalPrimeID: 01095071SKY7658
                    LastCellAccessUTC: '2015-11-10 14:59:29'
                    UpdateUTC: '2023-10-10 14:59:29'
                  - PrimeID: 01000005SKYCD96
                    Description: Terminal de teste 002
                    LastRegionName: AMERRB9
                    MTSN: 01000005SKYCD96
                    IMEI: '359739077429070'
                    LastRegistrationUTC: '2022-01-22 20:00:24'
                    LastRegistrationMessageID: 784365876345
                    LastSatelliteNetwork: 1
                    LastOperationMode: 0
                    LastCellAccessUTC: '2022-01-22 21:10:14'
                    UpdateUTC: '2023-11-22 21:10:14'
        '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:
    GetTerminalInfoUpdatesResponse:
      description: >-
        Resposta de atualizações das informações do terminal - inclui uma lista
        de registros atualizados de informações de terminais das contas do
        usuário.
      properties:
        ErrorID:
          description: >-
            Presente somente em caso de falha. O valor ErrorID serve como
            referência para entender a causa do erro.
          example: 0
        NextFromUTC:
          description: "Contém o valor do próximo campo FromUTC que o cliente precisa fornecer em uma requisição para receber registros contíguos.\r\nPode ser omitido em caso de erro ou se nenhum registro foi retornado.\r\nSe você faz polling regular para atualizações, deve usar essa marcação (high-water mark) nas requisições seguintes.\r\nReusar valores de marcação (FromUTC) ao obter muitos registros pode resultar em limitação (throttling) das próximas requisições."
          example: '2022-11-25 12:00:03'
        Terminals:
          description: Array de registros de informações de terminais.

````