Need to pass Authorization header along with AUTH_TOKEN. Otherwise it will return Unauthorized (http - 401)

Example

      curl -x POST https://backend.workers.dev/faculty \
         -H 'Authorization: AUTH_TOKEN' \    # required for authentication
         -d '{name: "Xron Trix"}'

• 200 - OK
• 204 - No Content
• 400 - Bad Request
• 401 - Unauthorized
• 404 - Not Found
• 405 - Method not Allowed
• 409 - Data conflicts
• 422 - Unprocessable Entity
• 500 - Server error

• GET
• POST
• PUT
• DELETE

• / - Check if Server is Online
• /faculties - Access Faculty Members Data
• /members - Access Regular Members Data
• /events - Access Event Data

Unique ID Will be Auto Added on Creation on Each Data

Each Field is Required on POST request

• Faculty

    {
       name: "String",
       role: "String",
       image: "String",
       mobile: "String"
    }

• Member

    {
       name: "String",
       role: "String",
       image: "String",
       mobile: "String",
       roll: "String"
    }

• Event

    {
       title: "String",
       page: "String",
       image: "String"
    }

Accepts

• POST /<API_ROUTE> {json in body} - Create Single Data

• GET /<API_ROUTE> - Read All Data

• GET /<API_ROUTE>/<ID> - Read Single Data

• GET /<API_ROUTE>?<KEY>=<VALUE> - Filter Data by Key

• PUT /<API_ROUTE>/<ID> - Update Single Data

• DELETE /<API_ROUTE> - Delete All Data

• DELETE /<API_ROUTE>/<ID> - Delete Single Data

  
  

Returns

Returns an Object of Following Properties on Success

   {
     "id": # ID of the object (if any or null),
     "collection": # Table Name of the Data,
     "results": [
       {
         # Query results object array (if any or null)
       }
     ],
     "time": # Time taken on Operation in milliseconds,
     "success": # Boolean value
   }

Also Returns HTTP status

• Create

  • Returns http - 200 on Success
  • Returns http - 409 on Data Conflict
  • Returns http - 422 on Unprocessable Entity
  • Returns http - 500 on Creation error

• Read

  • Returns http - 200 on Success
  • Returns http - 404 on Not Found

• Update

  • Returns http - 200 on Success
  • Returns http - 404 on Not Found
  • Returns http - 422 on Unprocessable Entity
  • Returns http - 500 on Update error

• Delete

  • Returns http - 200 on Success
  • Returns http - 404 on Not Found
  • Returns http - 500 on Update error

• Create a Cloudflare Account if haven't already 🙂

• Create a subdomain for your workers pages.

  Your Projects will be visible as https://project.SUB_DOMAIN.workers.dev

• Install node.js if haven't already 🙂

• Install Wrangler as

  npm install wrangler --save-dev

• Login with Cloudflare Account

  wrangler login

• Clone This Repository

  git clone https://github.com/XronTrix10/Cloudflare-RESTful-D1.git

• Rename wrangler.sample.toml file to wrangler.toml

• Rename sample.dev.vars file to .dev.vars

• Put a secret Auth Token in .dev.vars file. This Token will be used to Authenticate You with Your API

• Put the auth token in Wrangler as well

  wrangler secret put AUTH_TOKEN

  Enter The Same Token you Placed inside .dev.vars file

• Install dependencies

  npm install

• Create a D1 Database in Cloudflare

  wrangler d1 create DATABASE_NAME

  📝 NOTE: Replace your own desired Database Name with DATABASE_NAME

  On Hitting Enter, an ID of the created namespace will be returned.

• Put Binding in wrangler.toml file

  • Replace <DATABASE_NAME> with Your Chosen Database Name and <unique-ID-for-your-database> with the ID you got on Database Creation

    📝 NOTE: ❌ Don't Edit the Binding Name binding = "DB"

• To Deploy/Test in Local

  wrangler dev

• To Deploy in Cloudflare

  wrangler deploy

  📝 NOTE: You can change the project name by editing the name field from wrangler.toml file before deploying your project