Formatar número

POST/tools/format_number

Gerada do contrato OpenAPI

Formata um número com as casas decimais e os separadores que você escolher: 1995.5 vira 1.995,50. Use para mostrar um valor em reais numa mensagem.

Requisição

curl -X POST "https://app.nextagsai.com.br/api/tools/format_number" \
  -H "X-ACCESS-TOKEN: $NEXTAGS_API_KEY" \
  --data-urlencode 'number=1995.5' \
  --data-urlencode 'decimals=2' \
  --data-urlencode 'decimal_separator=,' \
  --data-urlencode 'thousands_separator=.'

const resposta = await fetch('https://app.nextagsai.com.br/api/tools/format_number', {
  method: 'POST',
  headers: {
    'X-ACCESS-TOKEN': process.env.NEXTAGS_API_KEY,
  },
  body: new URLSearchParams({
    number: 1995.5,
    decimals: 2,
    decimal_separator: ',',
    thousands_separator: '.',
  }),
});
const dados = await resposta.json();
console.log(resposta.status, dados);

import os

import requests

resposta = requests.post(
    "https://app.nextagsai.com.br/api/tools/format_number",
    headers={"X-ACCESS-TOKEN": os.environ["NEXTAGS_API_KEY"]},
    data={
        "number": 1995.5,
        "decimals": 2,
        "decimal_separator": ",",
        "thousands_separator": ".",
    },
    timeout=30,
)
print(resposta.status_code, resposta.json())

<?php
$ch = curl_init('https://app.nextagsai.com.br/api/tools/format_number');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'X-ACCESS-TOKEN: ' . getenv('NEXTAGS_API_KEY'),
    ],
    CURLOPT_POSTFIELDS => http_build_query([
        'number' => 1995.5,
        'decimals' => 2,
        'decimal_separator' => ',',
        'thousands_separator' => '.',
    ]),
]);
$dados = json_decode(curl_exec($ch), true);
echo curl_getinfo($ch, CURLINFO_HTTP_CODE), PHP_EOL;
print_r($dados);

Autenticação

Mande a chave de API da conta no cabeçalho X-ACCESS-TOKEN de cada chamada. Veja Autenticação com a chave de API.

Corpo da requisição

FormulárioContent-Type: application/x-www-form-urlencoded

numbernumberobrigatório

O número, com ponto decimal (1995.5).

decimalsinteger

Quantas casas decimais, como 2.

decimal_separatorstring

O separador decimal, como ,.

thousands_separatorstring

O separador de milhar, como ..

Respostas

200Sucesso

O número formatado, em data.

datastring ou number

O número formatado. Com separadores, vem como texto.

401Chave inválida

A chave de API não veio no cabeçalho ou não vale (foi excluída ou está incompleta). Veja Autenticação.

Relacionados

Codificar para URL (RFC 3986)

POST /tools/rawurlencode

Este conteúdo ajudou?

Obrigado! Sua resposta ajuda a melhorar a central.

curl -X POST "https://app.nextagsai.com.br/api/tools/format_number" \ -H "X-ACCESS-TOKEN: $NEXTAGS_API_KEY" \ --data-urlencode 'number=1995.5' \ --data-urlencode 'decimals=2' \ --data-urlencode 'decimal_separator=,' \ --data-urlencode 'thousands_separator=.'

const resposta = await fetch('https://app.nextagsai.com.br/api/tools/format_number', { method: 'POST', headers: { 'X-ACCESS-TOKEN': process.env.NEXTAGS_API_KEY, }, body: new URLSearchParams({ number: 1995.5, decimals: 2, decimal_separator: ',', thousands_separator: '.', }), }); const dados = await resposta.json(); console.log(resposta.status, dados);

import os import requests resposta = requests.post( "https://app.nextagsai.com.br/api/tools/format_number", headers={"X-ACCESS-TOKEN": os.environ["NEXTAGS_API_KEY"]}, data={ "number": 1995.5, "decimals": 2, "decimal_separator": ",", "thousands_separator": ".", }, timeout=30, ) print(resposta.status_code, resposta.json())

<?php $ch = curl_init('https://app.nextagsai.com.br/api/tools/format_number'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_HTTPHEADER => [ 'X-ACCESS-TOKEN: ' . getenv('NEXTAGS_API_KEY'), ], CURLOPT_POSTFIELDS => http_build_query([ 'number' => 1995.5, 'decimals' => 2, 'decimal_separator' => ',', 'thousands_separator' => '.', ]), ]); $dados = json_decode(curl_exec($ch), true); echo curl_getinfo($ch, CURLINFO_HTTP_CODE), PHP_EOL; print_r($dados);