API

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.

ParameterDescriptionTypeDefault
qValue to be search in first_name, middle_name, last_name, display_name, email and id ColumnString
per_pageN Item Per PageNumber20
fromInitial DateString
(Y-m-d)
toFinal DateString
(Y-m-d)
statusStatus of Registration and may be either email-verification-vending, email-verified or user-createdString
trashedSet true to show Trashed (Soft Delete) dataBooleanfalse
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": "&laquo; Previous",
                    "active": false
                },
                {
                    "url": "<public-url>/api/registrations?page=1",
                    "label": "1",
                    "active": true
                },
                {
                    "url": null,
                    "label": "Next &raquo;",
                    "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.

ParameterDescriptionTypeDefault
qValue to be search in first_name, middle_name, last_name, display_name, email and id ColumnString
per_pageN Item Per PageNumber20
fromInitial DateString
(Y-m-d)
toFinal DateString
(Y-m-d)
statusStatus of User and may be either active or inactiveString
trashedSet true to show Trashed (Soft Delete) dataBooleanfalse
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": "&laquo; Previous",
                    "active": false
                },
                {
                    "url": "<public-url>/api/users?page=1",
                    "label": "1",
                    "active": true
                },
                {
                    "url": null,
                    "label": "Next &raquo;",
                    "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": "&laquo; 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 &raquo;",
                    "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": "&laquo; 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 &raquo;",
                    "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.

ParameterDescriptionTypeDefault
qValue to be search in name and slug ColumnString
per_pageN Item Per PageNumber20
fromInitial DateString
(Y-m-d)
toFinal DateString
(Y-m-d)
filterStatus of Role and may be either active, inactive, frontend or backendString
trashedSet true to show Trashed (Soft Delete) dataBooleanfalse
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": "&laquo; Previous",
                    "active": false
                },
                {
                    "url": "<public-url>/api/roles?page=1",
                    "label": "1",
                    "active": true
                },
                {
                    "url": null,
                    "label": "Next &raquo;",
                    "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": "&laquo; 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 &raquo;",
                    "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": "&laquo; 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 &raquo;",
                    "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.

ParameterDescriptionTypeDefault
qValue to be search in name and slug ColumnString
per_pageN Item Per PageNumber20
fromInitial DateString
(Y-m-d)
toFinal DateString
(Y-m-d)
filterStatus of Permission and may be either active, inactive or {module_name}String
sectionif filter = {module_name}String
trashedSet true to show Trashed (Soft Delete) dataBooleanfalse
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": "&laquo; Previous",
                    "active": false
                },
                {
                    "url": "<public-url>/api/permissions?page=1",
                    "label": "1",
                    "active": true
                },
                {
                    "url": null,
                    "label": "Next &raquo;",
                    "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": "&laquo; 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 &raquo;",
                    "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": "&laquo; 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 &raquo;",
                    "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.

ParameterDescriptionTypeDefault
qValue to be search in name and slug ColumnString
per_pageN Item Per PageNumber20
fromInitial DateString
(Y-m-d)
toFinal DateString
(Y-m-d)
statusStatus of taxonomy and may be either active or inactiveString
trashedSet true to show Trashed (Soft Delete) dataBooleanfalse
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": "&laquo; Previous",
                    "active": false
                },
                {
                    "url": "<public-url>/api/taxonomies?page=1",
                    "label": "1",
                    "active": true
                },
                {
                    "url": null,
                    "label": "Next &raquo;",
                    "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.

ParameterDescriptionTypeDefault
qValue to be search in name and slug ColumnString
per_pageN Item Per PageNumber20
fromInitial DateString
(Y-m-d)
toFinal DateString
(Y-m-d)
with_childrenWhen true, get Response with children attributeBooleanfalse
trashedSet true to show Trashed (Soft Delete) dataBooleanfalse
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": "&laquo; Previous",
                    "active": false
                },
                {
                    "url": "<public-url>/api/taxonomy-types?page=1",
                    "label": "1",
                    "active": true
                },
                {
                    "url": null,
                    "label": "Next &raquo;",
                    "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"
    ]
}