# RESTful API Principles

The Blueink API is built on RESTful principles, using standard HTTP methods and status codes to manage resources.

## Base URL
All API requests are made to:
`https://api.blueink.com/api/v2/`

## HTTP Verbs
We use standard HTTP methods for different types of operations:

| Method | Description |
| :--- | :--- |
| `GET` | Retrieve a resource or a list of resources. |
| `POST` | Create a new resource. |
| `PUT` | Update an existing resource (full update). |
| `PATCH` | Partially update an existing resource. |
| `DELETE` | Remove a resource. |

## HTTP Status Codes
The API returns standard HTTP status codes to indicate the success or failure of a request:

| Code | Status | Description |
| :--- | :--- | :--- |
| `200` | OK | Request succeeded. |
| `201` | Created | Resource was successfully created. |
| `204` | No Content | Request succeeded, but there is no content to return. |
| `400` | Bad Request | The request was invalid or missing required parameters. |
| `401` | Unauthorized | Authentication failed or was missing. |
| `403` | Forbidden | You do not have permission to access the resource. |
| `404` | Not Found | The requested resource could not be found. |
| `429` | Too Many Requests | Rate limit exceeded. |
| `500` | Server Error | An internal error occurred on our servers. |