πŸ˜΅β€πŸ’«Authentication Method

How to authenticate requests that needs authentication

Authentication Documentation

Introduction

This document provides guidelines for authenticating requests to the PAAL AI API. Authentication is required for creating, modifying, and deleting project data, but it is not required for retrieving project data.

Authentication Header

To authenticate requests, include an HTTP header with the following structure:

  • Header Name: Bearer

  • Header Value: Your authentication token

Example Header

Bearer: your-authentication-token

Example Usage

Including Authentication Header in Requests

When making requests to the API endpoints that require authentication, ensure you include the Bearer token in the headers.

Using cURL

curl -X POST 'https://paal-ecosystem-backend.onrender.com/project/new' \
-H 'Content-Type: application/json' \
-H 'Bearer: your-authentication-token' \
-d '{
  "name": "Project Alpha",
  "about": "This project focuses on AI development.",
  "growth": "20%"
}'

Using JavaScript (Fetch API)

fetch('https://paal-ecosystem-backend.onrender.com/project/new', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Bearer': 'your-authentication-token'
  },
  body: JSON.stringify({
    name: 'Project Alpha',
    about: 'This project focuses on AI development.',
    growth: '20%'
  })
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

Using Postman

  1. Open Postman and create a new request.

  2. Select the request method (e.g., POST).

  3. Enter the request URL (e.g., https://api.example.com/project/new).

  4. Go to the Headers tab.

  5. Add another header:

    • Key: Bearer

    • Value: your-authentication-token

  6. Go to the Body tab, select raw and set the type to JSON.

  7. Enter the request payload in JSON format.

  8. Send the request.

Using Axios (JavaScript)

const axios = require('axios');

axios.post('https://paal-ecosystem-backend.onrender.com/project/new', {
  name: 'Project Alpha',
  about: 'This project focuses on AI development.',
  growth: '20%'
}, {
  headers: {
    'Content-Type': 'application/json',
    'Bearer': 'your-authentication-token'
  }
})
.then(response => console.log(response.data))
.catch(error => console.error('Error:', error));

Summary

By including the Bearer token in the request headers, you can authenticate your requests to the PAAL AI API. Ensure your token is valid and correctly included in the headers to access the protected endpoints for creating, modifying, and deleting data.

Last updated