Skip to main content

Endpoints

Endpoints are created under projects and are used to store your data.

These REST endpoints use the HTTP protocol’s request types, they receive CREATE, READ, UPDATE and DELETE requests, regardless of the technology used in your application.

Example:

https://app.rested.dev/api/1/ce/examples/unsecure-endpoint?key=d59eb2859c284168ac48aef65046d5dd

Breakdown:

https://app.rested.dev/api/1/ce -> Base URL

examples/unsecure-endpoint -> Endpoint name

d59eb2859c284168ac48aef65046d5dd -> API Key of the project

TIP: You should create different endpoints to manage different types of data. For example, you can create an endpoint for users and one endpoint for companies.

danger

If you delete an endpoint, all the data associated with it is deleted permanently and it is NOT recoverable.

Endpoint options

Property nameDefinition
Endpoint name

This is the name of your endpoint and needs to be unique, if it already exists there will be an error.

Validation rule: Must only contain lowercase letters, numbers, hyphens and "/". Also, it must not start or end with "/" or "-", not contain double "-" and the length must be between 5 and 254.

Example:

"my-project/cars"
DescriptionNot mandatory. You can use this field to add additional information about this endpoint.
Authentication endpointWith this option enabled you can use this endpoint to authenticate your users, and you can also secure other endpoints.

For more information about authentication endpoints please check the documentation for Authentication endpoints.

Secure

When an endpoint is secure, the user needs to login first using the Authentication endpoint, otherwise the data is not accessible.

For more information please refer to the login documentation and secure endpoints documentation.

Additional data access options

Use these options to control who can access the data stored in your secure endpoints.

OptionDefinition
Data can be READ by other authenticated users

This option is selected by default.

With this option enabled, authenticated users can access the data created by other users. If this option is disabled, the next two options are disabled automatically.

Data can be MODIFIED by other authenticated users

This option is selected by default.

With this option enabled, authenticated users can modify the data created by other users.

Email endpoints don't support this option as the data cannot be modified.

Data can be READ by non-authenticated users

This option is NOT selected by default.

With this option enabled, non-authenticated users can access all the data existing in the endpoint.

Continue reading to check all what you can do with RESTED_DEV endpoints.