๐Ÿ“˜ Npoint Uz Documentation

Welcome to the official Npoint Uz Docs โ€” your guide to using JSON as an instant API! Whether you're a beginner developer looking to test your front-end app or someone who needs a quick mock API, Npoint Uz is here to help.

๐Ÿš€ What is Npoint Uz?

  • Create and save JSON documents in the browser.
  • Instantly generate a public or private API URL.
  • Use that URL in your projects just like any other REST API.
  • Share your mock API with others or keep it private.

๐Ÿ“ How to Use the Platform

1. Sign Up / Log In

Create an account or log in to access your dashboard.

2. Create a New JSON File

  • Click on โ€œNew JSONโ€ or the โ€œCreateโ€ button.
  • Give your document a title.
  • Enter your JSON data in the editor (we validate it in real-time).
  • Choose if you want it to be public or private.
  • Hit Save.

3. Access Your API URL

After saving, youโ€™ll get a special API endpoint:

https://npoint.uz/api/username/document-name/document-id

4. Manage Your Files

  • Edit your JSON anytime.
  • Delete it if you no longer need it.
  • Copy the API URL to your clipboard.
  • Toggle visibility (make it public/private).

5. Public vs Private

  • Public: Anyone with the link can view the JSON.
  • Private: Only you (when logged in) can access it.

๐Ÿ”’ Authentication & Security

All changes to your JSON require login. Public documents are accessible by link, and token.

๐Ÿ› ๏ธ Use Cases

  • Frontend apps during development
  • Mocking APIs for demos
  • JSON hosting for testing libraries and frameworks
  • Sharing structured data with teammates

๐Ÿ“ฌ Example API Response

API Examples All requests include: Authorization: Token YOUR_TOKEN

          // Browser fetch
          const url = "https://npoint.uz/api/johndoe/todolist/id";

          fetch(url, {
            headers: { "Authorization": "Token YOUR_TOKEN", "Accept": "application/json" }
          })
            .then(res => {
              if (!res.ok) throw new Error(res.status + " " + res.statusText);
              return res.json();
            })
            .then(data => console.log(data))
            .catch(console.error);
          
import requests

          url = "https://npoint.uz/api/johndoe/todolist/id"
          headers = {"Authorization": "Token YOUR_TOKEN", "Accept": "application/json"}

          resp = requests.get(url, headers=headers, timeout=15)
          resp.raise_for_status()
          print(resp.json())
          
curl -H "Authorization: Token YOUR_TOKEN" \
              -H "Accept: application/json" \
              https://npoint.uz/api/johndoe/todolist/id
          
<?php
          $ch = curl_init("https://npoint.uz/api/johndoe/todolist/id");
          curl_setopt_array($ch, [
            CURLOPT_HTTPHEADER => ["Authorization: Token YOUR_TOKEN", "Accept: application/json"],
            CURLOPT_RETURNTRANSFER => true,
          ]);
          $resp = curl_exec($ch);
          if (curl_errno($ch)) { throw new Exception(curl_error($ch)); }
          $status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
          curl_close($ch);
          if ($status !== 200) { throw new Exception("HTTP $status"); }
          echo $resp;
          
const axios = require("axios");
          const url = "https://npoint.uz/api/johndoe/todolist/id";

          axios.get(url, { headers: { Authorization: "Token YOUR_TOKEN" } })
            .then(res => console.log(res.data))
            .catch(err => console.error(err.response ? err.response.status : err.message));
          
import java.net.http.*;
          import java.net.URI;

          public class Example {
            public static void main(String[] args) throws Exception {
              String url = "https://npoint.uz/api/johndoe/todolist/id";
              HttpClient client = HttpClient.newHttpClient();
              HttpRequest req = HttpRequest.newBuilder(URI.create(url))
                  .header("Authorization", "Token YOUR_TOKEN")
                  .header("Accept", "application/json")
                  .build();
              HttpResponse<String> res = client.send(req, HttpResponse.BodyHandlers.ofString());
              System.out.println(res.body());
            }
          }
          
package main

          import (
            "fmt"
            "io"
            "net/http"
          )

          func main() {
            req, _ := http.NewRequest("GET", "https://npoint.uz/api/johndoe/todolist/id", nil)
            req.Header.Set("Authorization", "Token YOUR_TOKEN")
            req.Header.Set("Accept", "application/json")

            res, err := http.DefaultClient.Do(req)
            if err != nil { panic(err) }
            defer res.Body.Close()
            body, _ := io.ReadAll(res.Body)
            fmt.Println(string(body))
          }
          
require "net/http"
          require "json"

          uri = URI("https://npoint.uz/api/johndoe/todolist/id")
          req = Net::HTTP::Get.new(uri)
          req["Authorization"] = "Token YOUR_TOKEN"
          req["Accept"] = "application/json"

          res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(req) }
          puts JSON.pretty_generate(JSON.parse(res.body))