API

Templates

Index

Retrieve a paginated list of all templates.

Usage

Endpoint

GET /api/v1/templates

Expected Response Code

200

Response Fields

  • data: array<object>
    • id: int
    • name: string
    • content: string
    • created_at: datetime
    • updated_at: datetime

Sample Request

GET /api/v1/templates HTTP/1.1
Host: sendyak.local
Authorization: Bearer 9w2fN7d4F3Banyv7gihYOWJEH6MvtYyZ
Accept: application/json

Sample Response

 1{
 2    "data": [
 3        {
 4            "id": 1,
 5            "name": "Template Name",
 6            "content": "Template Content",
 7            "created_at": "2020-07-17 09:48:07",
 8            "updated_at": "2020-07-17 09:48:07"
 9        }
10    ],
11    "links": {
12        "first": "http://sendyak.test/api/v1/templates?page=1",
13        "last": "http://sendyak.test/api/v1/templates?page=1",
14        "prev": null,
15        "next": null
16    },
17    "meta": {
18        "current_page": 1,
19        "from": 1,
20        "last_page": 1,
21        "path": "http://sendyak.test/api/v1/templates",
22        "per_page": 25,
23        "to": 1,
24        "total": 1
25    }
26}

Show

Retrieve the details of a single template.

Usage

Endpoint

GET /api/v1/templates/{templateId}

Expected Response Code

200

Response Fields

  • data: object
    • id: int
    • name: string
    • content: string
    • created_at: datetime
    • updated_at: datetime

Sample Request

GET /api/v1/templates/1 HTTP/1.1
Host: sendyak.local
Authorization: Bearer 9w2fN7d4F3Banyv7gihYOWJEH6MvtYyZ
Accept: application/json

Sample Response

1{
2    "data": {
3        "id": 1,
4        "name": "Template Name",
5        "content": "Template Content",
6        "created_at": "2020-07-17 09:48:07",
7        "updated_at": "2020-07-17 09:48:07"
8    }
9}

Store

Create a new template.

Usage

Endpoint

POST /api/v1/templates

Expected Response Code

201

Request Fields

  • name: string
  • content: string

Response Fields

  • data: object
    • id: int
    • name: string
    • content: string
    • created_at: datetime
    • updated_at: datetime

Sample Request

POST /api/v1/templates HTTP/1.1
Host: sendyak.local
Authorization: Bearer 9w2fN7d4F3Banyv7gihYOWJEH6MvtYyZ
Accept: application/json
Content-Type: application/json

{
	"name": "Test Template",
	"content": "Test Content"
}

Sample Response

1{
2    "data": {
3        "id": 3,
4        "name": "Test Template",
5        "content": "Test Content",
6        "created_at": "2020-07-17 09:55:10",
7        "updated_at": "2020-07-17 09:55:10"
8    }
9}

Update

Endpoint

PUT /api/v1/templates/{templateId}

Expected Response Code

200

Description

Update the details of the given template.

Request Fields

  • name: string
  • content: string

Response Fields

  • data: object
    • id: int
    • name: string
    • content: string
    • created_at: datetime
    • updated_at: datetime

Sample Request

PUT /api/v1/templates/3 HTTP/1.1
Host: sendyak.local
Authorization: Bearer 9w2fN7d4F3Banyv7gihYOWJEH6MvtYyZ
Accept: application/json
Content-Type: application/json

{
	"name": "Test Template",
	"content": "Content"
}

Sample Response

1{
2    "data": {
3        "id": 3,
4        "name": "Test Template",
5        "content": "Content",
6        "created_at": "2020-07-17 09:55:10",
7        "updated_at": "2020-07-17 09:57:07"
8    }
9}

Delete

Delete the given template.

Usage

Endpoint

DELETE /api/v1/templates/{templateId}

Expected Response Code

204

Sample Request

DELETE /api/v1/templates/3 HTTP/1.1
Host: sendyak.local
Authorization: Bearer 9w2fN7d4F3Banyv7gihYOWJEH6MvtYyZ
Accept: application/json