Rannz Developer API

Metadata npm, repository GitHub, UUID, dan hash dalam satu API.

GET/api/v1/dev/npmFreecache 15 menit

Metadata paket npm

Versi terbaru, lisensi, jumlah dependensi, dan unduhan 7 hari terakhir untuk sebuah paket npm.

Parameter	Lokasi	Tipe	Wajib	Keterangan
name	query	string	Ya	Nama paket npm (boleh bercakupan, contoh @scope/paket).

Contoh request

curl "https://layananapirannz.web.id/api/v1/dev/npm?name=react" \
  -H "Authorization: Bearer YOUR_API_KEY"

Contoh respons sukses (200)

{
  "data": {
    "name": "react",
    "latestVersion": "19.2.0",
    "description": "React is a JavaScript library for building user interfaces.",
    "license": "MIT",
    "homepage": "https://react.dev/",
    "repository": "git+https://github.com/facebook/react.git",
    "keywords": [
      "react"
    ],
    "dependencyCount": 0,
    "engines": {
      "node": ">=0.10.0"
    },
    "unpackedSizeBytes": 172000,
    "downloadsLastWeek": 25000000
  },
  "meta": {
    "requestId": "…",
    "endpoint": "dev.npm",
    "cached": false
  }
}

Nilai pada contoh bersifat ilustrasi; bentuk (skema) respons sama dengan yang sebenarnya.

Contoh respons error

{
  "error": {
    "code": "INVALID_INPUT",
    "message": "Input tidak valid.",
    "requestId": "…",
    "details": [
      {
        "field": "name",
        "message": "Parameter wajib diisi"
      }
    ]
  }
}

400 INVALID_INPUT Input tidak valid (parameter hilang, tipe salah, atau di luar batas).
401 INVALID_API_KEY API key tidak ada, salah format, dicabut, atau kedaluwarsa.
403 PREMIUM_REQUIRED Endpoint membutuhkan paket Premium aktif untuk layanan tersebut.
403 KEY_RESTRICTED API key dibatasi dan tidak boleh mengakses layanan ini.
404 NOT_FOUND Endpoint atau data yang diminta tidak ditemukan.
429 RATE_LIMITED Rate limit per menit terlampaui. Lihat header Retry-After.
429 QUOTA_EXCEEDED Kuota harian terlampaui. Kuota direset 00:00 UTC.
502 UPSTREAM_ERROR Sumber data (provider upstream) gagal atau mengembalikan respons tidak valid.
502 UPSTREAM_TIMEOUT Sumber data tidak merespons dalam batas waktu.

GET/api/v1/dev/github/repoFreecache 10 menit

Ringkasan repository GitHub publik

Bintang, fork, bahasa, lisensi, topik, dan waktu push terakhir.

Parameter	Lokasi	Tipe	Wajib	Keterangan
repo	query	string	Ya	Repository publik dalam format owner/nama.

Contoh request

curl "https://layananapirannz.web.id/api/v1/dev/github/repo?repo=vercel%2Fnext.js" \
  -H "Authorization: Bearer YOUR_API_KEY"

Contoh respons sukses (200)

{
  "data": {
    "fullName": "vercel/next.js",
    "description": "The React Framework",
    "url": "https://github.com/vercel/next.js",
    "stars": 130000,
    "forks": 28000,
    "openIssues": 3000,
    "language": "JavaScript",
    "license": "MIT",
    "topics": [
      "react",
      "nextjs"
    ],
    "archived": false,
    "isFork": false,
    "defaultBranch": "canary",
    "createdAt": "2016-10-05T23:32:51Z",
    "pushedAt": "2026-10-17T10:00:00Z"
  },
  "meta": {
    "requestId": "…",
    "endpoint": "dev.github.repo",
    "cached": false
  }
}

Nilai pada contoh bersifat ilustrasi; bentuk (skema) respons sama dengan yang sebenarnya.

Contoh respons error

{
  "error": {
    "code": "INVALID_INPUT",
    "message": "Input tidak valid.",
    "requestId": "…",
    "details": [
      {
        "field": "repo",
        "message": "Parameter wajib diisi"
      }
    ]
  }
}

400 INVALID_INPUT Input tidak valid (parameter hilang, tipe salah, atau di luar batas).
401 INVALID_API_KEY API key tidak ada, salah format, dicabut, atau kedaluwarsa.
403 PREMIUM_REQUIRED Endpoint membutuhkan paket Premium aktif untuk layanan tersebut.
403 KEY_RESTRICTED API key dibatasi dan tidak boleh mengakses layanan ini.
404 NOT_FOUND Endpoint atau data yang diminta tidak ditemukan.
429 RATE_LIMITED Rate limit per menit terlampaui. Lihat header Retry-After.
429 QUOTA_EXCEEDED Kuota harian terlampaui. Kuota direset 00:00 UTC.
502 UPSTREAM_ERROR Sumber data (provider upstream) gagal atau mengembalikan respons tidak valid.
502 UPSTREAM_TIMEOUT Sumber data tidak merespons dalam batas waktu.

GET/api/v1/dev/github/releasesPremiumcache 10 menit

Rilis terbaru sebuah repository GitHub

Daftar rilis (tanpa draft) berurutan dari yang terbaru. Endpoint Premium.

Parameter	Lokasi	Tipe	Wajib	Keterangan
repo	query	string	Ya	Repository publik dalam format owner/nama.
limit	query	integer	Tidak	Jumlah rilis (1-30). Default: 10. Rentang: 1 - 30.

Contoh request

curl "https://layananapirannz.web.id/api/v1/dev/github/releases?repo=vercel%2Fnext.js" \
  -H "Authorization: Bearer YOUR_API_KEY"

Contoh respons sukses (200)

{
  "data": {
    "repo": "vercel/next.js",
    "releases": [
      {
        "tag": "v15.5.0",
        "name": "v15.5.0",
        "url": "https://github.com/vercel/next.js/releases/tag/v15.5.0",
        "prerelease": false,
        "publishedAt": "2026-08-01T10:00:00Z"
      }
    ]
  },
  "meta": {
    "requestId": "…",
    "endpoint": "dev.github.releases",
    "cached": false
  }
}

Nilai pada contoh bersifat ilustrasi; bentuk (skema) respons sama dengan yang sebenarnya.

Contoh respons error

{
  "error": {
    "code": "INVALID_INPUT",
    "message": "Input tidak valid.",
    "requestId": "…",
    "details": [
      {
        "field": "repo",
        "message": "Parameter wajib diisi"
      }
    ]
  }
}

400 INVALID_INPUT Input tidak valid (parameter hilang, tipe salah, atau di luar batas).
401 INVALID_API_KEY API key tidak ada, salah format, dicabut, atau kedaluwarsa.
403 PREMIUM_REQUIRED Endpoint membutuhkan paket Premium aktif untuk layanan tersebut.
403 KEY_RESTRICTED API key dibatasi dan tidak boleh mengakses layanan ini.
404 NOT_FOUND Endpoint atau data yang diminta tidak ditemukan.
429 RATE_LIMITED Rate limit per menit terlampaui. Lihat header Retry-After.
429 QUOTA_EXCEEDED Kuota harian terlampaui. Kuota direset 00:00 UTC.
502 UPSTREAM_ERROR Sumber data (provider upstream) gagal atau mengembalikan respons tidak valid.
502 UPSTREAM_TIMEOUT Sumber data tidak merespons dalam batas waktu.

GET/api/v1/dev/uuidFree

Generate UUID v4

UUID v4 acak dari CSPRNG server. Dihitung lokal, tanpa sumber eksternal.

Parameter	Lokasi	Tipe	Wajib	Keterangan
count	query	integer	Tidak	Jumlah UUID (1-100). Default: 1. Rentang: 1 - 100.

Contoh request

curl "https://layananapirannz.web.id/api/v1/dev/uuid" \
  -H "Authorization: Bearer YOUR_API_KEY"

Contoh respons sukses (200)

{
  "data": {
    "uuids": [
      "3f2b8c1e-5d4a-4e6f-9a1b-0c2d3e4f5a6b"
    ]
  },
  "meta": {
    "requestId": "…",
    "endpoint": "dev.uuid",
    "cached": false
  }
}

Nilai pada contoh bersifat ilustrasi; bentuk (skema) respons sama dengan yang sebenarnya.

Contoh respons error

{
  "error": {
    "code": "INVALID_INPUT",
    "message": "Input tidak valid.",
    "requestId": "…",
    "details": [
      {
        "field": "count",
        "message": "Parameter wajib diisi"
      }
    ]
  }
}

400 INVALID_INPUT Input tidak valid (parameter hilang, tipe salah, atau di luar batas).
401 INVALID_API_KEY API key tidak ada, salah format, dicabut, atau kedaluwarsa.
403 PREMIUM_REQUIRED Endpoint membutuhkan paket Premium aktif untuk layanan tersebut.
403 KEY_RESTRICTED API key dibatasi dan tidak boleh mengakses layanan ini.
404 NOT_FOUND Endpoint atau data yang diminta tidak ditemukan.
429 RATE_LIMITED Rate limit per menit terlampaui. Lihat header Retry-After.
429 QUOTA_EXCEEDED Kuota harian terlampaui. Kuota direset 00:00 UTC.
502 UPSTREAM_ERROR Sumber data (provider upstream) gagal atau mengembalikan respons tidak valid.
502 UPSTREAM_TIMEOUT Sumber data tidak merespons dalam batas waktu.

POST/api/v1/dev/hashFree

Hitung hash teks

Menghitung digest heksadesimal dari teks UTF-8 (sha256, sha512, sha1, md5). Dihitung lokal; teks tidak disimpan.

Parameter	Lokasi	Tipe	Wajib	Keterangan
text	body JSON	string	Ya	Teks yang di-hash (maks 10.000 karakter).
algorithm	body JSON	sha256 \| sha512 \| sha1 \| md5	Tidak	Algoritma hash. Default: sha256.

Contoh request

curl -X POST "https://layananapirannz.web.id/api/v1/dev/hash" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"halo rannz"}'

Contoh respons sukses (200)

{
  "data": {
    "algorithm": "sha256",
    "hash": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
    "inputBytes": 4
  },
  "meta": {
    "requestId": "…",
    "endpoint": "dev.hash",
    "cached": false
  }
}

Nilai pada contoh bersifat ilustrasi; bentuk (skema) respons sama dengan yang sebenarnya.

Contoh respons error

{
  "error": {
    "code": "INVALID_INPUT",
    "message": "Input tidak valid.",
    "requestId": "…",
    "details": [
      {
        "field": "text",
        "message": "Parameter wajib diisi"
      }
    ]
  }
}

400 INVALID_INPUT Input tidak valid (parameter hilang, tipe salah, atau di luar batas).
401 INVALID_API_KEY API key tidak ada, salah format, dicabut, atau kedaluwarsa.
403 PREMIUM_REQUIRED Endpoint membutuhkan paket Premium aktif untuk layanan tersebut.
403 KEY_RESTRICTED API key dibatasi dan tidak boleh mengakses layanan ini.
404 NOT_FOUND Endpoint atau data yang diminta tidak ditemukan.
429 RATE_LIMITED Rate limit per menit terlampaui. Lihat header Retry-After.
429 QUOTA_EXCEEDED Kuota harian terlampaui. Kuota direset 00:00 UTC.
502 UPSTREAM_ERROR Sumber data (provider upstream) gagal atau mengembalikan respons tidak valid.
502 UPSTREAM_TIMEOUT Sumber data tidak merespons dalam batas waktu.

Parameter

Lokasi

Tipe

Wajib

Keterangan

name

query

string

Nama paket npm (boleh bercakupan, contoh @scope/paket).

{ "data": { "name": "react", "latestVersion": "19.2.0", "description": "React is a JavaScript library for building user interfaces.", "license": "MIT", "homepage": "https://react.dev/", "repository": "git+https://github.com/facebook/react.git", "keywords": [ "react" ], "dependencyCount": 0, "engines": { "node": ">=0.10.0" }, "unpackedSizeBytes": 172000, "downloadsLastWeek": 25000000 }, "meta": { "requestId": "…", "endpoint": "dev.npm", "cached": false } }

{ "error": { "code": "INVALID_INPUT", "message": "Input tidak valid.", "requestId": "…", "details": [ { "field": "name", "message": "Parameter wajib diisi" } ] } }

Parameter

Lokasi

Tipe

Wajib

Keterangan

repo

query

string

Repository publik dalam format owner/nama.

{ "data": { "fullName": "vercel/next.js", "description": "The React Framework", "url": "https://github.com/vercel/next.js", "stars": 130000, "forks": 28000, "openIssues": 3000, "language": "JavaScript", "license": "MIT", "topics": [ "react", "nextjs" ], "archived": false, "isFork": false, "defaultBranch": "canary", "createdAt": "2016-10-05T23:32:51Z", "pushedAt": "2026-10-17T10:00:00Z" }, "meta": { "requestId": "…", "endpoint": "dev.github.repo", "cached": false } }

{ "error": { "code": "INVALID_INPUT", "message": "Input tidak valid.", "requestId": "…", "details": [ { "field": "repo", "message": "Parameter wajib diisi" } ] } }

Parameter

Lokasi

Tipe

Wajib

Keterangan

repo

query

string

Repository publik dalam format owner/nama.

limit

query

integer

Tidak

Jumlah rilis (1-30). Default: 10. Rentang: 1 - 30.

{ "data": { "repo": "vercel/next.js", "releases": [ { "tag": "v15.5.0", "name": "v15.5.0", "url": "https://github.com/vercel/next.js/releases/tag/v15.5.0", "prerelease": false, "publishedAt": "2026-08-01T10:00:00Z" } ] }, "meta": { "requestId": "…", "endpoint": "dev.github.releases", "cached": false } }

{ "error": { "code": "INVALID_INPUT", "message": "Input tidak valid.", "requestId": "…", "details": [ { "field": "repo", "message": "Parameter wajib diisi" } ] } }

Parameter

Lokasi

Tipe

Wajib

Keterangan

count

query

integer

Tidak

Jumlah UUID (1-100). Default: 1. Rentang: 1 - 100.

{ "error": { "code": "INVALID_INPUT", "message": "Input tidak valid.", "requestId": "…", "details": [ { "field": "count", "message": "Parameter wajib diisi" } ] } }

Parameter

Lokasi

Tipe

Wajib

Keterangan

text

body JSON

string

Teks yang di-hash (maks 10.000 karakter).

algorithm

body JSON

sha256 | sha512 | sha1 | md5

Tidak

Algoritma hash. Default: sha256.

{ "data": { "algorithm": "sha256", "hash": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08", "inputBytes": 4 }, "meta": { "requestId": "…", "endpoint": "dev.hash", "cached": false } }

{ "error": { "code": "INVALID_INPUT", "message": "Input tidak valid.", "requestId": "…", "details": [ { "field": "text", "message": "Parameter wajib diisi" } ] } }