Consultar Mensagens Recebidas por Período

Instruções para consulta de Mensagens Recebidas por Período

Importante:

As consultas possuem limite de 1 requisição a cada 30 segundos por endereço IP. Requisições além deste limite são respondidas com o código de status HTTP 429.

Replys by Period

GET https://message.uniqmobile.com.br/api/sms/replys-by-period/{dateFrom}&{dateTo}

Este endpoint permite que seja consultado todas as mensagens recebidas durante o período especificado.

Query Parameters

Name

Type

Description

dateFrom

string

Data inicial do relatório

dateTo

string

Data final do relatório

Headers

Name

Type

Description

Authentication

string

api-key para autenticação

{
    "Success": true,
    "Object": {
        "Report": [
            {
                "ReceivedDate": "2021-04-01T21:18:00",
                "SMSId": 123545
                "MessageReceived": "Conforme solicitado, essa e a resposta",
                "MessageSent": "Poderia me responder?",
                "MessageId": 72,
                "Number": "5598999999999",   
            }
        ]
    },
    "Message": "Relatório obtido com sucesso"
}

{
    "Success": true,
    "Object": {
        "Report": [
            {
                "ReceivedDate": "2021-04-01T21:18:00",
                "SMSId": 123545
                "MessageReceived": "Conforme solicitado, essa e a resposta",
                "MessageSent": "Poderia me responder?",
                "MessageId": 72,
                "Number": "5598999999999",   
            },
            {
                "ReceivedDate": "2021-04-02T14:57:00",
                "SMSId": 123684
                "MessageReceived": "Oi, esta e a minha resposta",
                "MessageSent": "Ola, pode me responder?",
                "MessageId": 85,
                "Number": "5598900000000",   
            }
        ]
    },
    "Message": "Relatório obtido com sucesso"
}

Exemplos

curl --request GET \
    --url https://message.uniqmobile.com.br/api/sms/replys-by-period/?dateFrom='dd/MM/yyyy'&dateTo='dd/MM/yyyy'\
    --header 'api-key: XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX' \

import requests
from requests.structures import CaseInsensitiveDict

url = "https://message.uniqmobile.com.br/api/sms/replys-by-period"

headers = CaseInsensitiveDict()
headers["api-key"] = "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
headers["Content-Type"] = "application/json"

querystring = {"dateFrom":"dd/MM/yyyy", "dateTo":"dd/MM/yyyy"}

resp = requests.get(url, headers=headers, params=querystring)

print(resp.status_code)
print(resp.text)

using System;
using System.IO;
using System.Net;

class MainClass {
  public static void Main (string[] args) {
    var dateFrom = "dd/MM/yyyy";
    var dateTo = "dd/MM/yyyy";

    var url = $"https://message.uniqmobile.com.br/api/sms/replys-by-period/?dateFrom={dateFrom}&dateTo={dateTo}";

    var httpRequest = (HttpWebRequest)WebRequest.Create(url);
    httpRequest.Method = "GET";

    httpRequest.Headers["api-key"] = "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX";
    httpRequest.ContentType = "application/json";


    var httpResponse = (HttpWebResponse)httpRequest.GetResponse();
    using (var streamReader = new StreamReader(httpResponse.GetResponseStream()))
    {
      var result = streamReader.ReadToEnd();
      Console.WriteLine(httpResponse.StatusCode);
      Console.WriteLine(result);
    }
  }
}

var dateFrom = "dd/MM/yyyy"
var dateTo = "dd/MM/yyyy"

var url = `https://message.uniqmobile.com.br/api/sms/replys-by-period/?dateFrom=${dateFrom}&dateTo=${dateTo}`;

var xhr = new XMLHttpRequest();
xhr.open("GET", url);

xhr.setRequestHeader("api-key", "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX");
xhr.setRequestHeader("Content-Type", "application/json");

xhr.onreadystatechange = function () {
    if (xhr.readyState === 4) {
        console.log(xhr.status);
        console.log(xhr.responseText);
    }
};

xhr.send();

<?php

$dateFrom = "dd/MM/yyyy";
$dateTo = "dd/MM/yyyy";
$url = "https://message.uniqmobile.com.br/api/sms/replys-by-period/?dateFrom={$dateFrom}&dateTo={$dateTo}";

$curl = curl_init($url);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);

$headers = array(
   "api-key: XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
   "Content-Type: application/json",
);
curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);

$resp = curl_exec($curl);
$statuscode = curl_getinfo($curl)["http_code"];
curl_close($curl);

var_dump($statuscode);
var_dump($resp);

?>

const https = require('https')

const dateFrom = "dd/MM/yyyy";
const dateTo = "dd/MM/yyyy";

const options = {
  hostname: 'message.uniqmobile.com.br',
  path: `/api/sms/replys-by-period/?dateFrom=${dateFrom}&dateTo=${dateTo}`,
  method: 'GET',
  headers: {
    'Content-Type': 'application/json',
    'api-key' : 'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX'
  }
}

const req = https.request(options, res => {
  console.log(`statusCode: ${res.statusCode}`)

  res.on('data', d => {
    process.stdout.write(d)
  })
})

req.on('error', error => {
  console.error(error)
})

req.end()

Campos de Retorno

Campos

Descrição

Success

Retorna TRUE se a requisição foi finalizada com sucesso ou FALSE se houve falhas

Object

Campo com os resultados da requisição

ReceivedDate

Data em que a mensagem foi respondida pelo destinatário

SMSId

Id do SMS que foi respondido

MessageReceived

Mensagem respondida pelo destinatário

Number

Numero que respondeu o SMS

MessageSent

Mensagem enviada ao destinatário

MessageId

ID da mensagem enviada

Message

Mensagem com mais detalhes sobre a requisição‌‌‌

Possíveis Retornos

HTTP Status

Mensagem

200

Relatório obtido com sucesso

401

Erro de Autenticação com a Api-key

401

Usuário Inativo

401

Usuário Não Encontrado

400

Data inicial maior que a data atual

400

Data Final menor que a Data Inicial

429

Muitas Requisições Realizadas

500

Erro no servidor

503

Sistema indisponível no momento

504

Houve um time out na requisição ao efetuar a conexão com o endpoint.

PreviousConsultar Status de SMS NextConsultar Mensagens Recebidas pela Mensagem Enviada

Last updated 4 years ago

Was this helpful?