Utils

v1 beta

UUIDs, hashes, base64 e inspeção de IP em uma chamada.

base url https://flye.win/v1/utils

visão geral

Utilitários de backend que todo projeto acaba reescrevendo. Respostas pequenas, sem estado e determinísticas onde faz sentido — ótima para validar sua integração com a flye.win antes de usar as outras APIs.

Autenticação, formato de erro e limites são iguais em todas as APIs — veja a documentação geral.

planos

Free

Grátis

Para testar e projetos pessoais.

quota/mês: 1.000
req/min: 30

1.000 requisições / mês
30 requisições / minuto
Todos os endpoints

Criar conta para assinar

Pro

Black Friday

US$ 2,89 no 1º mês

~~US$ 5,29~~ · depois US$ 5,29/mês

até 30 nov 2026

Para aplicações em produção.

quota/mês: 100.000
req/min: 300

100.000 requisições / mês
300 requisições / minuto
Logs de 30 dias

Criar conta para assinar

Cartão

Scale

Black Friday

US$ 23,59 no 1º mês

~~US$ 27,29~~ · depois US$ 27,29/mês

até 30 nov 2026

Volume alto, sem teto mensal.

quota/mês: ilimitado
req/min: 1.200

Requisições ilimitadas
1.200 requisições / minuto
Suporte prioritário

Criar conta para assinar

Cartão

Sua chave para testar aqui Pegar uma chave

Use uma chave de teste (flye_test_…): ela responde com os exemplos, sem gastar cota e sem precisar de plano. A chave fica só nesta aba do navegador e não é enviada ao nosso site.

GET /v1/utils/uuid — Gerar UUIDs

Gera de 1 a 100 UUIDs. A versão 7 é ordenável por tempo, boa para chaves primárias.

parâmetro	onde	tipo	descrição
count	query	integer	Quantidade, de 1 a 100. Padrão 1.
version	query	integer	4 (aleatório) ou 7 (ordenado por tempo). Padrão 4.

curl "https://flye.win/v1/utils/uuid?count=2&version=7" \
  -H "Authorization: Bearer $FLYE_KEY"

const res = await fetch("https://flye.win/v1/utils/uuid?count=2&version=7", {
  headers: {
    Authorization: `Bearer ${process.env.FLYE_KEY}`,
  },
});
const data = await res.json();
if (!res.ok) throw new Error(data.error.code);
console.log(data);

import os
import requests

res = requests.get(
    "https://flye.win/v1/utils/uuid?count=2&version=7",
    headers={"Authorization": f"Bearer {os.environ['FLYE_KEY']}"},
    timeout=30,
)
res.raise_for_status()
print(res.json())

req, _ := http.NewRequest("GET", "https://flye.win/v1/utils/uuid?count=2&version=7", nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("FLYE_KEY"))

res, err := http.DefaultClient.Do(req)
if err != nil {
	log.Fatal(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(res.Status, string(out))

<?php
$ch = curl_init('https://flye.win/v1/utils/uuid?count=2&version=7');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('FLYE_KEY')],
]);
$data = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
print_r($data);

resposta · 200

{
  "version": 7,
  "uuids": [
    "019a3c1e-7b2d-7c41-9f0e-5d8a21c4b6e3",
    "019a3c1e-7b2d-7f88-a1c2-0e93b7d45f12"
  ]
}

Testar agora

GET /v1/utils/hash — Calcular hash

Calcula o hash do texto informado e devolve em hex.

parâmetro	onde	tipo	descrição
text*	query	string	Texto de entrada (até 64 KB).
algo	query	string	md5, sha1, sha256 ou sha512. Padrão sha256.

curl "https://flye.win/v1/utils/hash?text=flye&algo=sha256" \
  -H "Authorization: Bearer $FLYE_KEY"

const res = await fetch("https://flye.win/v1/utils/hash?text=flye&algo=sha256", {
  headers: {
    Authorization: `Bearer ${process.env.FLYE_KEY}`,
  },
});
const data = await res.json();
if (!res.ok) throw new Error(data.error.code);
console.log(data);

import os
import requests

res = requests.get(
    "https://flye.win/v1/utils/hash?text=flye&algo=sha256",
    headers={"Authorization": f"Bearer {os.environ['FLYE_KEY']}"},
    timeout=30,
)
res.raise_for_status()
print(res.json())

req, _ := http.NewRequest("GET", "https://flye.win/v1/utils/hash?text=flye&algo=sha256", nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("FLYE_KEY"))

res, err := http.DefaultClient.Do(req)
if err != nil {
	log.Fatal(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(res.Status, string(out))

<?php
$ch = curl_init('https://flye.win/v1/utils/hash?text=flye&algo=sha256');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('FLYE_KEY')],
]);
$data = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
print_r($data);

resposta · 200

{
  "algo": "sha256",
  "hex": "9a5c3b4f1f8e0d6c…"
}

Testar agora

POST /v1/utils/base64 — Codificar / decodificar base64

Converte texto de e para base64 padrão (RFC 4648).

parâmetro	onde	tipo	descrição
text*	body	string	Conteúdo a converter.
mode	body	string	encode ou decode. Padrão encode.

curl -X POST "https://flye.win/v1/utils/base64" \
  -H "Authorization: Bearer $FLYE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mode":"encode","text":"hello, world"}'

const res = await fetch("https://flye.win/v1/utils/base64", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.FLYE_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"mode":"encode","text":"hello, world"}),
});
const data = await res.json();
if (!res.ok) throw new Error(data.error.code);
console.log(data);

import os
import requests

res = requests.post(
    "https://flye.win/v1/utils/base64",
    headers={"Authorization": f"Bearer {os.environ['FLYE_KEY']}"},
    json={"mode": "encode", "text": "hello, world"},
    timeout=30,
)
res.raise_for_status()
print(res.json())

body := strings.NewReader(`{"mode":"encode","text":"hello, world"}`)
req, _ := http.NewRequest("POST", "https://flye.win/v1/utils/base64", body)
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", "Bearer "+os.Getenv("FLYE_KEY"))

res, err := http.DefaultClient.Do(req)
if err != nil {
	log.Fatal(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(res.Status, string(out))

<?php
$ch = curl_init('https://flye.win/v1/utils/base64');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('FLYE_KEY'), 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"mode":"encode","text":"hello, world"}',
]);
$data = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
print_r($data);

resposta · 200

{
  "mode": "encode",
  "result": "aGVsbG8sIHdvcmxk"
}

Testar agora

GET /v1/utils/ip — IP de origem

Retorna o IP e o user-agent com que sua requisição chegou à plataforma.

curl "https://flye.win/v1/utils/ip" \
  -H "Authorization: Bearer $FLYE_KEY"

const res = await fetch("https://flye.win/v1/utils/ip", {
  headers: {
    Authorization: `Bearer ${process.env.FLYE_KEY}`,
  },
});
const data = await res.json();
if (!res.ok) throw new Error(data.error.code);
console.log(data);

import os
import requests

res = requests.get(
    "https://flye.win/v1/utils/ip",
    headers={"Authorization": f"Bearer {os.environ['FLYE_KEY']}"},
    timeout=30,
)
res.raise_for_status()
print(res.json())

req, _ := http.NewRequest("GET", "https://flye.win/v1/utils/ip", nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("FLYE_KEY"))

res, err := http.DefaultClient.Do(req)
if err != nil {
	log.Fatal(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(res.Status, string(out))

<?php
$ch = curl_init('https://flye.win/v1/utils/ip');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('FLYE_KEY')],
]);
$data = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
print_r($data);

resposta · 200

{
  "ip": "203.0.113.24",
  "user_agent": "curl/8.7.1"
}

Testar agora