0.4.11 • Published 10 months ago

@dpype/rest-at-rest v0.4.11

Weekly downloads
-
License
UNLICENSED
Repository
github
Last release
10 months ago

Everything API Endpoints

This document outlines the API endpoints exposed by the "Everything" API. The base path for all endpoints is /v[x], where x is a positive number. The current version is v2.

Authentication

  • POST /auth/refreshToken: Refresh an expired access token using a refresh token.
  • POST /auth/otp/request: Request a One-Time Password (OTP) for a resource.
  • POST /auth/otp/exchange: Verify an OTP and exchange it for an authentication session.

Resource Management

  • POST /api/{collectionName}/{resourceName}: Create a new resource within a specified collection.
  • GET /api/{collectionName}/{resourceName}: Retrieve a list of resources within a specified collection.
  • POST, PATCH, PUT /api/{collectionName}/{resourceName}/{resourceId}: Update an existing resource identified by its resourceId.
  • GET /api/{collectionName}/{resourceName}/{resourceId}: Retrieve a specific resource by its resourceId.

Resource Actions

  • POST /api/{collectionName}/{resourceName}/{resourceId}/actions/{actionType}/{destination}: Perform an action on a resource. The specific action type and destination depend on the use case.

Resource Permissions

  • POST /api/{collectionName}/{resourceName}/{resourceId}/permissions/{accessType}: Assign a permission level (accessType) to a resource.

Notes

  • {collectionName} and {resourceName} are placeholders for the collection and resource names, respectively.
  • {resourceId} is a placeholder for the unique identifier of a specific resource.
  • {actionType} and {destination} define actions that can be performed on a resource.
  • {accessType} determines the permission level granted to a resource.

API Endpoints Overview

General Endpoints

MethodEndpointDescription
GET/v2/Base API endpoint
POST/v2/requests/{requestName}Submit a request
GET/v2/contents/{contentName}/{slug}Retrieve specific content
GET/v2/static/{type}/{slug}Retrieve static content
ANY/v2/{proxy+}Proxy endpoint for dynamic routes

Expanded Proxy Routes

MethodEndpointFunction
GET/content/{name}/{slug}staticAssetHandler
POST/requests/{requestName}/{requestId}requestHandler
GET/static/{name}/{slug}staticAssetHandler
GET/auth/passwordless/{slug}passwordLessLoginHandler
POST/auth/refreshTokenrefreshTokenHandler
POST/auth/otp/requestrequestResourceOTPHandler
POST/auth/otp/exchangeexchangeResourceOTPHandler
POST/api/{collectionName}/{resourceName}/{resourceId}/actions/{actionType}/{destination}tagResourceHandler
POST/api/{collectionName}/{resourceName}/{resourceId}/permissions/{accessType}assignResourcePermissionHandler
POST/api/{collectionName}/{resourceName}/{resourceId}/files/createsignUrlForFileUpload
POST/api/{collectionName}/{resourceName}/{resourceId}/files/updateupdateSignedUrlForFileAccess
POST/api/{collectionName}/{resourceName}createResourceHandler
GET/api/{collectionName}/{resourceName}listResourceHandler
POST, PATCH, PUT/api/{collectionName}/{resourceName}/{resourceId}updateResourceHandler
GET/api/{collectionName}/{resourceName}/{resourceId}getResourceHandler

This document serves as a quick reference for API usage and route configurations.

0.4.9

10 months ago

0.4.8

10 months ago

0.1.86

1 year ago

0.1.87

1 year ago

0.3.0

1 year ago

0.4.11

10 months ago

0.2.1

1 year ago

0.2.0

1 year ago

0.4.5

10 months ago

0.4.4

10 months ago

0.4.6

10 months ago

0.4.1

10 months ago

0.4.0

10 months ago

0.2.2

1 year ago

0.4.3

10 months ago

0.4.2

10 months ago

0.1.85

1 year ago

0.1.83

1 year ago

0.1.82

1 year ago

0.1.81

1 year ago

0.1.80

1 year ago

0.1.79

1 year ago

0.1.78

2 years ago

0.1.77

2 years ago

0.1.76

2 years ago

0.1.75

2 years ago

0.1.74

2 years ago

0.1.73

2 years ago

0.1.72

2 years ago

0.1.71

2 years ago

0.1.70

2 years ago

0.1.69

2 years ago

0.1.68

2 years ago

0.1.67

2 years ago

0.1.66

2 years ago

0.1.65

2 years ago

0.1.64

2 years ago

0.1.63

2 years ago

0.1.62

2 years ago

0.1.61

2 years ago

0.1.60

2 years ago

0.1.59

2 years ago

0.1.55

2 years ago

0.1.53

2 years ago

0.1.52

2 years ago

0.1.51

2 years ago

0.1.50

2 years ago

0.1.49

2 years ago

0.1.46

2 years ago

0.1.45

2 years ago

0.1.44

2 years ago

0.1.43

2 years ago

0.1.42

2 years ago

0.1.41

2 years ago

0.1.40

2 years ago

0.1.39

2 years ago

0.1.38

2 years ago

0.1.37

2 years ago

0.1.36

2 years ago

0.1.35

2 years ago

0.1.34

2 years ago

0.1.33

2 years ago

0.1.29

2 years ago

0.1.28

2 years ago

0.1.27

2 years ago

0.1.25

2 years ago

0.1.24

2 years ago

0.1.21

2 years ago

0.1.20

2 years ago

0.1.19

2 years ago

0.1.18

2 years ago

0.1.17

2 years ago

0.1.15

2 years ago

0.1.14

2 years ago

0.1.13

2 years ago

0.1.12

2 years ago

0.1.11

2 years ago

0.1.10

2 years ago

0.1.9

2 years ago

0.1.8

2 years ago

0.1.6

2 years ago

0.1.5

2 years ago

0.1.3

2 years ago

0.1.2

2 years ago

0.1.1

2 years ago

0.0.3

2 years ago