Utils

v1 beta

UUIDs, hashes, base64 and IP inspection in one call.

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

overview

Backend utilities every project ends up rewriting. Small, stateless responses, deterministic where it makes sense. A good way to validate your flye.win integration before using other APIs.

Authentication, error format, and limits are the same across all APIs. See the general docs.

plans

Free

For testing and personal projects.

quota/month: 1,000
req/min: 30

1,000 requests / month
30 requests / minute
All endpoints

Create an account to subscribe

Pro

Black Friday

US$ 2.89 first month

~~US$ 5.29~~ · then US$ 5.29/mo

until Nov 30, 2026

For production applications.

quota/month: 100,000
req/min: 300

100,000 requests / month
300 requests / minute
30-day logs

Create an account to subscribe

Card

Scale

Black Friday

US$ 23.59 first month

~~US$ 27.29~~ · then US$ 27.29/mo

until Nov 30, 2026

High volume, no monthly cap.

quota/month: unlimited
req/min: 1,200

Unlimited requests
1,200 requests / minute
Priority support

Create an account to subscribe

Card

Your key to test here Get a key

Use a test key (flye_test_…): it answers with the examples, without using quota or needing a plan. The key stays in this browser tab only and is never sent to our site.

GET /v1/utils/uuid — Generate UUIDs

Generates 1 to 100 UUIDs. Version 7 sorts by time, which suits primary keys.

parameter	in	type	description
count	query	integer	How many, from 1 to 100. Defaults to 1.
version	query	integer	4 (random) or 7 (time-ordered). Defaults to 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);

response · 200

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

Try it now

GET /v1/utils/hash — Compute a hash

Hashes the given text and returns it as hex.

parameter	in	type	description
text*	query	string	Input text (up to 64 KB).
algo	query	string	md5, sha1, sha256 or sha512. Defaults to 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);

response · 200

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

Try it now

POST /v1/utils/base64 — Encode / decode base64

Converts text to and from standard base64 (RFC 4648).

parameter	in	type	description
text*	body	string	Content to convert.
mode	body	string	encode or decode. Defaults to 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);

response · 200

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

Try it now

GET /v1/utils/ip — Source IP

Returns the IP and user agent your request reached the platform with.

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);

response · 200

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

Try it now