Search

This endpoint allows you to generate random passwords. To access the /password endpoint, you will need to provide the proper authentication using the Authorization header.

Endpoint Details

The /password endpoint allows you to retrieve information about a specific password.

URL: /password
Method: GET
Content Type: application/json

Authentication

To make requests to the /password endpoint, you must include an Authorization header in your API calls. This header should contain a valid access token.

Example Authorization Header

Authorization: YOUR_ACCESS_TOKEN

Replace YOUR_ACCESS_TOKEN with the actual token provided to you.

Request

Headers

The request to the /password endpoint should be a JSON object with the following headers:

Header	Type	Description	Required
`Authorization`	string	The unique identifier of the user sending the request.	True

Parameters

The request parameters for the /password endpoint.

Parameter	Type	Description	Required
`charLength`	number	(Optional) The desired length of the generated password. If not provided, a default length is used.	False

Example Request

Here's an example of how to make a request to the /password endpoint.

import axios from "axios";
 
/*
Replace "YOUR_ACCESS_TOKEN" with the token you got from the Kohai Bot and the endpoint.
*/
const url = "https://waifu.it/api/v4/password";
const charLength = 12; // Replace with your desired password length (optional).
const data = async () => {
  try {
    const { data } = await axios.get(url, { 
      headers: {
        Authorization: "YOUR_ACCESS_TOKEN",
        },
      params: {
        charLength: charLength || undefined,
      }
  });
    return data;
  } catch (err) {
    throw new Error(err.message);
  }
};
 
console.log(data);

Remember to replace YOUR_ACCESS_TOKEN with your actual access token.

Responses

The server will respond with an appropriate message based on the input provided. A successfully API request will respond with a JSON object containing the following information:

password: The unique password that is generated for you.
status: Response status

Content Type: application/json

  "password": "&CbO891uM7G3"
  "status": 200,

This documentation should help you use axios (opens in a new tab) for Node.js and requests (opens in a new tab) for Python to interact with the /password endpoint.

Search Search