API
YOU'RE READING AN OUTDATED DOCUMENTATION.
Latest documentation of
VaahCMS 2.x is available at: Introduction
When building an API, you may need a transformation layer that sits between your Eloquent models and the JSON responses that are actually returned to your application's users. For example, you may wish to display certain attributes for a subset of users and not others, or you may wish to always include certain relationships in the JSON representation of your models. Eloquent's resource classes allow you to expressively and easily transform your models and model collections into JSON.
Of course, you may always convert Eloquent models or collections to JSON using their toJson methods; however, Eloquent resources provide more granular and robust control over the JSON serialization of your models and their relationships.
Sign In
To get authorization token you need to sign in first. after the successfully sign in,
an api_token in the response will be there which you can use as authorization token.
For sign in follow below link :
POST <public-url>/api/signin
Request samples
let params = {
email:"",
password:"",
}
Response samples
{
"status": "success",
"data": {
"item": {
.............
.............
"api_token": "3EsIxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxdyN9",
}
}
}
Sign Up
If you don't have an account by using sign up you can create account
For sign up follow below link :
POST <public-url>/api/signup
Request samples
let params = {
first_name:"",
email:"",
password:"",
password_confirmation:"",
}
Response samples
{
"status": "success",
"data": {
"item": {
.............
.............
}
},
"messages": [
"Saved successfully"
]
}
Authentication
VaahCms supports API authentication.
This allows you to protect the URLs on your web server so that only you can access them.
In order to authenticate with HTTP, you may provide a API Token in Header.
The most common way of accessing OAuth 2.0 APIs is using a “Bearer Token”. This is a single string which acts as the authentication of the API request, sent in an HTTP “Authorization” header. The string is meaningless to clients using it, and may be of varying lengths.
Authorization: Bearer <api-token>
You can ask to Admin for assigning you a API Token.
The following is a curl example using the HTTP Authorization header using the Bearer schema with a line break and spaces for readability.
curl -H 'Authorization: Bearer <api-token>' \
<public-url>/api/users
Registration
Create
Create new registration with HTTP request. During the creation you can set up attributes.
URL
GET/POST <public-url>/api/registrations/create
Request samples
let params = {
api_token:''
email:"",
username:"",
password:"",
display_name:"",
title:"",
designation:"",
first_name:"",
middle_name:"",
last_name:"",
gender:"",
country_calling_code:"",
phone:"",
bio:"",
timezone:"",
alternate_email:"",
avatar_url:"",
birth:"",
country:"",
country_code:"",
status:"",
activation_code:"",
activation_code_sent_at:"",
activated_ip:"",
invited_by:"",
invited_at:"",
invited_for_key:"",
invited_for_value:"",
user_id:"",
user_created_at:"",
created_ip:"",
registration_id:"",
meta:""
}
Response samples
{
"status": "success",
"data": {
"item": {
.............
.............
}
},
"messages": [
"Saved successfully."
]
}
Get a List
Get a list of the Registration objects and their properties in a list with Pagination.
This method supports some of the query parameters to help customize the response.
| Parameter | Description | Type | Default |
|---|---|---|---|
| q | Value to be search in first_name, middle_name, last_name, display_name, email and id Column | String | |
| per_page | N Item Per Page | Number | 20 |
| from | Initial Date | String (Y-m-d) | |
| to | Final Date | String (Y-m-d) | |
| status | Status of Registration and may be either email-verification-vending, email-verified or user-created | String | |
| trashed | Set true to show Trashed (Soft Delete) data | Boolean | false |
URL
GET/POST <public-url>/api/registrations
Request samples
let params = {
api_token:"",
q:"",
from:"",
to:"",
status:"",
per_page:"",
trashed:""
}
Response samples
{
"status": "success",
"data": {
"list": {
"current_page": 1,
"data": [
..............
..............
],
"first_page_url": "<public-url>/api/registrations?page=1",
"from": 1,
"last_page": 1,
"last_page_url": "<public-url>/api/registrations?page=1",
"links": [
{
"url": null,
"label": "« Previous",
"active": false
},
{
"url": "<public-url>/api/registrations?page=1",
"label": "1",
"active": true
},
{
"url": null,
"label": "Next »",
"active": false
}
],
"next_page_url": null,
"path": "<public-url>/api/registrations",
"per_page": 20,
"prev_page_url": null,
"to": 2,
"total": 2
}
}
}
Get Item
Get a Item of the Registration objects. This will retrieves a User by their custom attributes, and returns all the properties of Registration.
Column can be id, uuid, email, username or Registration's attribute and their value.
URL
GET/POST <public-url>/api/registrations/{column}/{value}
Request samples
let params = {
api_token:"",
trashed:""
}
Response samples
{
"status": "success",
"data": {
.............
.............
}
}
Update
Simple HTTP request to Registrations API and you can update standard attributes for a user within few seconds!
Column can be id, uuid, email, username or Registration's attribute and their value.
URL
GET/POST <public-url>/api/registrations/{column}/{value}/update
Request samples
let params = {
api_token:''
email:"",
username:"",
password:"",
display_name:"",
title:"",
designation:"",
first_name:"",
middle_name:"",
last_name:"",
gender:"",
country_calling_code:"",
phone:"",
bio:"",
timezone:"",
alternate_email:"",
avatar_url:"",
birth:"",
country:"",
country_code:"",
status:"",
activation_code:"",
activation_code_sent_at:"",
activated_ip:"",
invited_by:"",
invited_at:"",
invited_for_key:"",
invited_for_value:"",
user_id:"",
user_created_at:"",
created_ip:"",
registration_id:"",
meta:""
}
Response samples
{
"status": "success",
"messages": [
"Saved"
],
"data": {
...........
...........
}
}
Delete
Simple HTTP request to Registration API to delete registration.
Column can be id, uuid, email, username or Registration's attribute and their value.
URL
GET/POST <public-url>/api/registrations/{column}/{value}/delete
Response samples
{
"status": "success",
"data": [],
"messages": [
"Action was successful"
]
}
Create User
Simple HTTP request to Registration API to create User.
URL
GET/POST <public-url>/api/registrations/{column}/{value}/create-user
Response samples
{
"status": "success",
"data": {
"user": {
...........
...........
}
},
"messages": [
"User is created."
]
}
Users
The User API provides operations to manage users in your organization.
Create user
Create new user with HTTP request. During the creation you can set up attributes.
URL
GET <public-url>/api/users/create?api_token=xxxxxxxxxxx
Request samples
POST <public-url>/api/users/create
let params = {
api_token:"",
email:"",
username:"",
password:"",
display_name:"",
title:"",
designation:"",
first_name:"",
middle_name:"",
last_name:"",
gender:"",
country_calling_code:"",
phone:"",
bio:"",
timezone:"",
alternate_email:"",
avatar_url:"",
birth:"",
country:"",
country_code:"",
is_active:"",
status:"",
activation_code:"",
activation_code_sent_at:"",
activated_ip:"",
invited_by:"",
invited_at:"",
invited_for_key:"",
invited_for_value:"",
user_id:"",
user_created_at:"",
created_ip:"",
registration_id:"",
meta:""
}
Response samples
{
"status": "success",
"data": {
"item": {
..........
..........
}
},
"messages": [
"Saved successfully."
]
}
Get a List of Users
Get a list of the User objects and their properties in a list with Pagination.
This method supports some of the query parameters to help customize the response.
| Parameter | Description | Type | Default |
|---|---|---|---|
| q | Value to be search in first_name, middle_name, last_name, display_name, email and id Column | String | |
| per_page | N Item Per Page | Number | 20 |
| from | Initial Date | String (Y-m-d) | |
| to | Final Date | String (Y-m-d) | |
| status | Status of User and may be either active or inactive | String | |
| trashed | Set true to show Trashed (Soft Delete) data | Boolean | false |
URL
GET <public-url>/api/users?api_token=xxxxxxxxxxx
Request samples
POST <public-url>/api/users
let params = {
api_token:"",
q:"",
from:"",
to:"",
status:"",
per_page:"",
trashed:""
}
Response samples
{
"status": "success",
"data": {
"list": {
"current_page": 1,
"data": [
..............
..............
],
"first_page_url": "<public-url>/api/users?page=1",
"from": 1,
"last_page": 1,
"last_page_url": "<public-url>/api/users?page=1",
"links": [
{
"url": null,
"label": "« Previous",
"active": false
},
{
"url": "<public-url>/api/users?page=1",
"label": "1",
"active": true
},
{
"url": null,
"label": "Next »",
"active": false
}
],
"next_page_url": null,
"path": "<public-url>/api/users",
"per_page": 20,
"prev_page_url": null,
"to": 2,
"total": 2
}
}
}
Get User Item
Get a Item of the User objects .
This will retrieves a User by their custom attributes, and returns all the properties of User.
Column can be id, uuid, email, username or User's attribute and their value.
URL
<public-url>/api/cms/users/{column}/{value}`
Request samples
let params = {
trashed:""
}
Response samples
{
"status": "success",
"data": {
.............
.............
}
}
Update
Simple HTTP request to Users API and you can update standard attributes for a user within few seconds!
Column can be id, uuid, email, username or User's attribute and their value.
URL
GET/POST <public-url>/api/users/{column}/{value}/update
Request samples
let params = {
api_token:''
email:"",
username:"",
password:"",
display_name:"",
title:"",
designation:"",
first_name:"",
middle_name:"",
last_name:"",
gender:"",
country_calling_code:"",
phone:"",
bio:"",
website:"",
timezone:"",
alternate_email:"",
avatar_url:"",
birth:"",
country:"",
country_code:"",
last_login_at:"",
last_login_ip:"",
remember_token:"",
login_otp:"",
api_token:"",
api_token_used_at:"",
api_token_used_ip:"",
is_active:"",
activated_at:"",
status:"",
affiliate_code:"",
affiliate_code_used_at:"",
reset_password_code:"",
reset_password_code_sent_at:"",
reset_password_code_used_at:"",
foreign_user_id:"",
meta:""
created_ip:"" api_token:''
email:"",
username:"",
password:"",
display_name:"",
title:"",
designation:"",
first_name:"",
middle_name:"",
last_name:"",
gender:"",
country_calling_code:"",
phone:"",
bio:"",
website:"",
timezone:"",
alternate_email:"",
avatar_url:"",
birth:"",
country:"",
country_code:"",
last_login_at:"",
last_login_ip:"",
remember_token:"",
login_otp:"",
api_token:"",
api_token_used_at:"",
api_token_used_ip:"",
is_active:"",
activated_at:"",
status:"",
affiliate_code:"",
affiliate_code_used_at:"",
reset_password_code:"",
reset_password_code_sent_at:"",
reset_password_code_used_at:"",
foreign_user_id:"",
meta:""
created_ip:""
}
Response samples
{
"status": "success",
"messages": [
"Saved"
],
"data": {
...........
...........
}
}
Delete
Simple HTTP request to Users API to delete user.
Column can be id, uuid, email, username or User's attribute and their value.
URL
GET/POST <public-url>/api/users/{column}/{value}/delete
Response samples
{
"status": "success",
"data": [],
"messages": [
"Action was successful"
]
}
Get User's Roles
Get user's roles via GET/POST request.
Column can be id, uuid, email, username or User's attribute and their value.
URL
GET/POST <public-url>/api/users/{column}/{value}/roles
Request samples
let params = {
api_token:"",
q:"",
per_page:""
}
Response samples
{
"data": {
"user": {
.............
.............
},
"roles": {
"current_page": 1,
"data": [
..............
..............
],
"first_page_url": "http://localhost/vikram/vaahcms-dev-env/public/api/users/id/2/roles?page=1",
"from": 1,
"last_page": 1,
"last_page_url": "http://localhost/vikram/vaahcms-dev-env/public/api/users/id/2/roles?page=1",
"links": [
{
"url": null,
"label": "« Previous",
"active": false
},
{
"url": "http://localhost/vikram/vaahcms-dev-env/public/api/users/id/2/roles?page=1",
"label": "1",
"active": true
},
{
"url": null,
"label": "Next »",
"active": false
}
],
"next_page_url": null,
"path": "http://localhost/vikram/vaahcms-dev-env/public/api/users/id/2/roles",
"per_page": 20,
"prev_page_url": null,
"to": 3,
"total": 3
}
},
"status": "success"
}
User has Role
API to check if an user has a specific role.
Column can be id, uuid, email, username or User's attribute and their value.
URL
GET/POST <public-url>/api/users/{column}/{value}/roles/{role_slug}
Response samples
{
"data": true/false,
"status": "success"
}
Get User's Permissions
Get user's permissions via GET/POST request.
Column can be id, uuid, email, username or User's attribute and their value.
URL
GET/POST <public-url>/api/users/{column}/{value}/permissions
Request samples
let params = {
api_token:"",
q:"",
per_page:""
}
Response samples
{
"data": {
"user": {
.............
.............
},
"permissions": {
"current_page": 1,
"data": [
..............
..............
],
"first_page_url": "http://localhost/vikram/vaahcms-dev-env/public/api/users/{column}/{value}/permissions?page=1",
"from": 1,
"last_page": 1,
"last_page_url": "http://localhost/vikram/vaahcms-dev-env/public/api/users/{column}/{value}/permissions?page=1",
"links": [
{
"url": null,
"label": "« Previous",
"active": false
},
{
"url": "http://localhost/vikram/vaahcms-dev-env/public/api/users/{column}/{value}/permissions?page=1",
"label": "1",
"active": true
},
{
"url": null,
"label": "Next »",
"active": false
}
],
"next_page_url": null,
"path": "http://localhost/vikram/vaahcms-dev-env/public/api/users/{column}/{value}/permissions",
"per_page": 20,
"prev_page_url": null,
"to": 3,
"total": 3
}
},
"status": "success"
}
User has Permission
API to check if an user has a specific permission.
Column can be id, uuid, email, username or User's attribute and their value.
URL
GET/POST <public-url>/api/users/{column}/{value}/permissions/{permission_slug}
Response samples
{
"data": true/false,
"status": "success"
}
Roles
Create
Create new role with HTTP request. During the creation you can set up attributes.
URL
GET/POST <public-url>/api/roles/create
Request samples
let params = {
api_token:""
name:"",
slug:"",
details:"",
is_active:"",
type:"",
}
Response samples
{
"status": "success",
"data": {
"item": {
..........
..........
}
},
"messages": [
"Saved successfully."
]
}
Get a List
Get a list of the Role objects and their properties in a list with Pagination.
This method supports some of the query parameters to help customize the response.
| Parameter | Description | Type | Default |
|---|---|---|---|
| q | Value to be search in name and slug Column | String | |
| per_page | N Item Per Page | Number | 20 |
| from | Initial Date | String (Y-m-d) | |
| to | Final Date | String (Y-m-d) | |
| filter | Status of Role and may be either active, inactive, frontend or backend | String | |
| trashed | Set true to show Trashed (Soft Delete) data | Boolean | false |
URL
GET/POST <public-url>/api/roles
Request samples
let params = {
api_token:"",
q:"",
from:"",
to:"",
filter:"",
per_page:"",
trashed:""
}
Response samples
{
"status": "success",
"data": {
"list": {
"current_page": 1,
"data": [
..............
..............
],
"first_page_url": "<public-url>/api/roles?page=1",
"from": 1,
"last_page": 1,
"last_page_url": "<public-url>/api/roles?page=1",
"links": [
{
"url": null,
"label": "« Previous",
"active": false
},
{
"url": "<public-url>/api/roles?page=1",
"label": "1",
"active": true
},
{
"url": null,
"label": "Next »",
"active": false
}
],
"next_page_url": null,
"path": "<public-url>/api/roles",
"per_page": 20,
"prev_page_url": null,
"to": 2,
"total": 2
}
}
}
Get Item
Get a Item of the Role objects . This will retrieves a Role by their custom attributes, and returns all the properties of Role.
Column can be id, uuid, email, username or Role's attribute and their value.
URL
GET/POST <public-url>/api/roles/{column}/{value}
Request samples
let params = {
api_tokenapi_token:"",
trashedtrashed:""
}
Response samples
{
"status": "success",
"data": {
.............
.............
}
}
Update
Simple HTTP request to Role API and you can update standard attributes for a role within few seconds!
Column can be id, uuid, email, username or Role's attribute and their value.
URL
GET/POST <public-url>/api/roles/{column}/{value}/update
Request samples
let params = {
api_token:'',
name:"",
slug:"",
details:"",
is_active:"",
type:"",
}
Response samples
{
"status": "success",
"messages": [
"Saved"
],
"data": {
...........
...........
}
}
Delete
Simple HTTP request to Role API to delete user.
Column can be id, uuid, email, username or Role's attribute and their value.
URL
GET/POST <public-url>/api/roles/{column}/{value}/delete
Response samples
{
"status": "success",
"data": [],
"messages": [
"Action was successful"
]
}
Get Role's Users
Get role's users via GET/POST request.
Column can be id, uuid, email, username or Role's attribute and their value.
URL
GET/POST <public-url>/api/roles/{column}/{value}/users
Request samples
let params = {
api_token:"",
q:"",
per_page:""
}
Response samples
{
"data": {
"role": {
.............
.............
},
"users": {
"current_page": 1,
"data": [
..............
..............
],
"first_page_url": "http://localhost/vikram/vaahcms-dev-env/public/api/roles/id/2/users?page=1",
"from": 1,
"last_page": 1,
"last_page_url": "http://localhost/vikram/vaahcms-dev-env/public/api/roles/id/2/users?page=1",
"links": [
{
"url": null,
"label": "« Previous",
"active": false
},
{
"url": "http://localhost/vikram/vaahcms-dev-env/public/api/roles/id/2/users?page=1",
"label": "1",
"active": true
},
{
"url": null,
"label": "Next »",
"active": false
}
],
"next_page_url": null,
"path": "http://localhost/vikram/vaahcms-dev-env/public/api/roles/id/2/users",
"per_page": 20,
"prev_page_url": null,
"to": 3,
"total": 3
}
},
"status": "success"
}
Get Role's Permissions
Get role's permissions via GET/POST request.
Column can be id, uuid, email, username or Role's attribute and their value.
URL
GET/POST <public-url>/api/roles/{column}/{value}/permissions
Request samples
let params = {
api_token:"",
q:"",
per_page:""
}
Response samples
{
"data": {
"role": {
.............
.............
},
"permissions": {
"current_page": 1,
"data": [
..............
..............
],
"first_page_url": "http://localhost/vikram/vaahcms-dev-env/public/api/roles/{column}/{value}/permissions?page=1",
"from": 1,
"last_page": 1,
"last_page_url": "http://localhost/vikram/vaahcms-dev-env/public/api/roles/{column}/{value}/permissions?page=1",
"links": [
{
"url": null,
"label": "« Previous",
"active": false
},
{
"url": "http://localhost/vikram/vaahcms-dev-env/public/api/roles/{column}/{value}/permissions?page=1",
"label": "1",
"active": true
},
{
"url": null,
"label": "Next »",
"active": false
}
],
"next_page_url": null,
"path": "http://localhost/vikram/vaahcms-dev-env/public/api/roles/{column}/{value}/permissions",
"per_page": 20,
"prev_page_url": null,
"to": 3,
"total": 3
}
},
"status": "success"
}
Permission
Get a List
Get a list of the Permission objects and their properties in a list with Pagination.
This method supports some of the query parameters to help customize the response.
| Parameter | Description | Type | Default |
|---|---|---|---|
| q | Value to be search in name and slug Column | String | |
| per_page | N Item Per Page | Number | 20 |
| from | Initial Date | String (Y-m-d) | |
| to | Final Date | String (Y-m-d) | |
| filter | Status of Permission and may be either active, inactive or {module_name} | String | |
| section | if filter = {module_name} | String | |
| trashed | Set true to show Trashed (Soft Delete) data | Boolean | false |
URL
GET/POST <public-url>/api/permissions
Request samples
let params = {
api_token:"",
q:"",
from:"",
to:"",
filter:"",
section:"",
per_page:"",
trashed:""
}
Response samples
{
"status": "success",
"data": {
"list": {
"current_page": 1,
"data": [
..............
..............
],
"first_page_url": "<public-url>/api/permissions?page=1",
"from": 1,
"last_page": 1,
"last_page_url": "<public-url>/api/permissions?page=1",
"links": [
{
"url": null,
"label": "« Previous",
"active": false
},
{
"url": "<public-url>/api/permissions?page=1",
"label": "1",
"active": true
},
{
"url": null,
"label": "Next »",
"active": false
}
],
"next_page_url": null,
"path": "<public-url>/api/permissions",
"per_page": 20,
"prev_page_url": null,
"to": 2,
"total": 2
}
}
}
Get Item
Get a Item of the Permission objects . This will retrieves a User by their custom attributes, and returns all the properties of Permission.
Column can be id, uuid, email, username or Permission's attribute and their value.
URL
GET/POST <public-url>/api/permissions/{column}/{value}
Request samples
let params = {
api_token:"",
trashed:""
}
Response samples
{
"status": "success",
"data": {
.............
.............
}
}
Delete
Simple HTTP request to Users API to delete permission.
Column can be id, uuid, email, username or Permission's attribute and their value.
URL
GET/POST <public-url>/api/roles/{column}/{value}/delete
Response samples
{
"status": "success",
"data": [],
"messages": [
"Action was successful"
]
}
Get Permission's Users
Get permission's users via GET/POST request.
Column can be id, uuid, email, username or Role's attribute and their value.
URL
GET/POST <public-url>/api/permissions/{column}/{value}/users
Request samples
let params = {
api_token:"",
q:"",
per_page:""
}
Response samples
{
"data": {
"role": {
.............
.............
},
"users": {
"current_page": 1,
"data": [
..............
..............
],
"first_page_url": "http://localhost/vikram/vaahcms-dev-env/public/api/permissions/id/2/users?page=1",
"from": 1,
"last_page": 1,
"last_page_url": "http://localhost/vikram/vaahcms-dev-env/public/api/permissions/id/2/users?page=1",
"links": [
{
"url": null,
"label": "« Previous",
"active": false
},
{
"url": "http://localhost/vikram/vaahcms-dev-env/public/api/permissions/id/2/users?page=1",
"label": "1",
"active": true
},
{
"url": null,
"label": "Next »",
"active": false
}
],
"next_page_url": null,
"path": "http://localhost/vikram/vaahcms-dev-env/public/api/permissions/id/2/users",
"per_page": 20,
"prev_page_url": null,
"to": 3,
"total": 3
}
},
"status": "success"
}
Get Permission's Roles
Get permission's roles via GET/POST request.
URL
GET/POST <public-url>/api/permissions/{column}/{value}/roles
Request samples
let params = {
api_token:"",
q:"",
per_page:""
}
Response samples
{
"data": {
"role": {
.............
.............
},
"permissions": {
"current_page": 1,
"data": [
..............
..............
],
"first_page_url": "http://localhost/vikram/vaahcms-dev-env/public/api/permissions/{column}/{value}/roles?page=1",
"from": 1,
"last_page": 1,
"last_page_url": "http://localhost/vikram/vaahcms-dev-env/public/api/permissions/{column}/{value}/roles?page=1",
"links": [
{
"url": null,
"label": "« Previous",
"active": false
},
{
"url": "http://localhost/vikram/vaahcms-dev-env/public/api/permissions/{column}/{value}/roles?page=1",
"label": "1",
"active": true
},
{
"url": null,
"label": "Next »",
"active": false
}
],
"next_page_url": null,
"path": "http://localhost/vikram/vaahcms-dev-env/public/api/permissions/{column}/{value}/roles",
"per_page": 20,
"prev_page_url": null,
"to": 3,
"total": 3
}
},
"status": "success"
}
Taxonomy
Create
Create new Create with HTTP request. During the creation you can set up attributes.
URL
GET/POST <public-url>/api/taxonomies/create
Request samples
let params = {
api_token:'',
name:"",
slug:"",
type:"",
parent:"",
}
Response samples
{
"status": "success",
"data": {
"item": {
..........
..........
}
},
"messages": [
"Saved successfully."
]
}
Get a List
Get a list of the Taxonomy objects and their properties in a list with Pagination.
This method supports some of the query parameters to help customize the response.
| Parameter | Description | Type | Default |
|---|---|---|---|
| q | Value to be search in name and slug Column | String | |
| per_page | N Item Per Page | Number | 20 |
| from | Initial Date | String (Y-m-d) | |
| to | Final Date | String (Y-m-d) | |
| status | Status of taxonomy and may be either active or inactive | String | |
| trashed | Set true to show Trashed (Soft Delete) data | Boolean | false |
URL
GET/POST <public-url>/api/taxonomies
Request samples
let params = {
api_token:"",
q:"",
from:"",
to:"",
status:"",
types:"",
per_page:"",
trashed:""
}
Response samples
{
"status": "success",
"data": {
"list": {
"current_page": 1,
"data": [
..............
..............
],
"first_page_url": "<public-url>/api/taxonomies?page=1",
"from": 1,
"last_page": 1,
"last_page_url": "<public-url>/api/taxonomies?page=1",
"links": [
{
"url": null,
"label": "« Previous",
"active": false
},
{
"url": "<public-url>/api/taxonomies?page=1",
"label": "1",
"active": true
},
{
"url": null,
"label": "Next »",
"active": false
}
],
"next_page_url": null,
"path": "<public-url>/api/taxonomies",
"per_page": 20,
"prev_page_url": null,
"to": 2,
"total": 2
}
}
}
Get Item
Get a Item of the Taxonomy objects . This will retrieves a User by their custom attributes, and returns all the properties of Taxonomy.
Column can be id, uuid, email, username or Taxonomy's attribute and their value.
URL
GET/POST <public-url>/api/taxonomies/{column}/{value}
Request samples
let params = {
api_token:"",
trashed:""
}
Response samples
{
"status": "success",
"data": {
.............
.............
}
}
Update
Simple HTTP request to Taxonomy API and you can update standard attributes for a user within few seconds!
Column can be id, uuid, email, username or Taxonomy's attribute and their value.
URL
GET/POST <public-url>/api/taxonomies/{column}/{value}/update
Request samples
let params = {
api_token:'',
name:"",
slug:"",
type:"",
parent:"",
}
Response samples
{
"status": "success",
"messages": [
"Saved"
],
"data": {
...........
...........
}
}
Delete
Simple HTTP request to Users API to delete taxonomy.
Column can be id, uuid, email, username or Taxonomy's attribute and their value.
URL
GET/POST <public-url>/api/taxonomies/{column}/{value}/delete
Response samples
{
"status": "success",
"data": [],
"messages": [
"Action was successful"
]
}
Taxonomy Type
Create
Create new Taxonomy Type with HTTP request. During the creation you can set up attributes.
URL
GET/POST <public-url>/api/taxonomy-types/create
Request samples
let params = {
api_token:'',
name:"",
slug:"",
parent:"",
}
Response samples
{
"status": "success",
"data": {
"item": {
..........
..........
}
},
"messages": [
"Saved successfully."
]
}
Get a List
Get a list of the Taxonomy Type objects and their properties in a list with Pagination.
This method supports some of the query parameters to help customize the response.
| Parameter | Description | Type | Default |
|---|---|---|---|
| q | Value to be search in name and slug Column | String | |
| per_page | N Item Per Page | Number | 20 |
| from | Initial Date | String (Y-m-d) | |
| to | Final Date | String (Y-m-d) | |
| with_children | When true, get Response with children attribute | Boolean | false |
| trashed | Set true to show Trashed (Soft Delete) data | Boolean | false |
URL
GET/POST <public-url>/api/taxonomy-types
Request samples
let params = {
api_token:"",
q:"",
from:"",
to:"",
per_page:"",
trashed:"",
with_children:""
}
Response samples
{
"status": "success",
"data": {
"list": {
"current_page": 1,
"data": [
..............
..............
],
"first_page_url": "<public-url>/api/taxonomy-types?page=1",
"from": 1,
"last_page": 1,
"last_page_url": "<public-url>/api/taxonomy-types?page=1",
"links": [
{
"url": null,
"label": "« Previous",
"active": false
},
{
"url": "<public-url>/api/taxonomy-types?page=1",
"label": "1",
"active": true
},
{
"url": null,
"label": "Next »",
"active": false
}
],
"next_page_url": null,
"path": "<public-url>/api/taxonomy-types",
"per_page": 20,
"prev_page_url": null,
"to": 2,
"total": 2
}
}
}
Get Item
Get a Item of the Taxonomy Type objects . This will retrieves a User by their custom attributes, and returns all the properties of Taxonomy Type.
Column can be id, uuid, email, username or Taxonomy Type's attribute and their value.
URL
GET/POST <public-url>/api/taxonomy-types/{column}/{value}
Request samples
let params = {
api_token:''
trashed:''
}
Response samples
{
"status": "success",
"data": {
.............
.............
}
}
Update
Simple HTTP request to Taxonomy type API and you can update standard attributes for a user within few seconds!
Column can be id, uuid, email, username or Taxonomy type's attribute and their value.
URL
GET/POST <public-url>/api/taxonomy-types/{column}/{value}/update
Request samples
let params = {
api_token:''
name:"",
slug:"",
parent:"",
}
Response samples
{
"status": "success",
"messages": [
"Saved"
],
"data": {
...........
...........
}
}
Delete
Simple HTTP request to Users API to delete taxonomy type.
Column can be id, uuid, email, username or Taxonomy type's attribute and their value.
URL
GET/POST <public-url>/api/taxonomy-types/{column}/{value}/delete
Response samples
{
"status": "success",
"data": [],
"messages": [
"Action was successful"
]
}