Links

CRUD endpoints for a user's custom links

Please note that in all urls & code samples you'll need to replace:username and :corporation with appropriate values

Get All Links

GET /v2/organization/:corporation/staff/:username/link

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Url

Name	Type	Description
corporation	number	Corporation ID
username	string	Unique username

Response

200

 {
  data: [
    {
      id: 1,
      name: "link name",
      url: "link url"
    }
  ],
  success: true
}

Code

Node

const accessToken = `<ACCESS TOKEN>`

fetch('https://public-api.expertfile.com/v2/organization/:corporation/staff/:username/link', {
    method: 'GET',
    headers: {
        'Content-Type': 'application/x-www-form-urlencoded',
        'Authorization': `Bearer ${accessToken}`
    }
})
.then(response => response.json())
.then(json => {
    const { success, data } = json

    if (success) {
        const links = data
        console.log('links', links)
    }

})
.catch(error => console.error(error));

PHP

Curl

Get Individual Link

GET /v2/organization/:corporation/staff/:username/link/:id

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Url

Name	Type	Description
corporation	number	Corporation ID
username	string	Unique username
id	number	Link ID

Response

200

{
  data: [
    {
      id: 1,
      name: "link name",
      url: "link url"
    }
  ],
  success: true
}

Code

Node

const accessToken = `<ACCESS CODE>`

fetch('https://public-api.expertfile.com/v2/organization/:corporation/staff/:username/link/:id', {
    method: 'GET',
    headers: {
        'Content-Type': 'application/x-www-form-urlencoded',
        'Authorization': `Bearer ${accessToken}`
    }
})
.then(response => response.json())
.then(json => {
    const { success, data } = json

    if (success) {
        const link = data
        console.log('links', link[0])
    }

})
.catch(error => console.error(error));

PHP

Curl

Create Link

POST /v2/organization/:corporation/staff/:username/link

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Url

Name	Type	Description
corporation	number	Corporation ID
username	string	Unique username

Body

Name	Type	Description
name*	string	Link Name
url*	string	Link Url *must be valid url

Response

200

{ 
    data: { 
        id: 1
    }, 
    success: true 
}

Code

Node

const data = new URLSearchParams();
const accessToken = `<ACCESS TOKEN>`

data.append('name', 'My Blog');
data.append('url', 'https://myblog.com');

fetch('https://public-api.expertfile.com/v2/organization/:corporation/staff/:username/link', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/x-www-form-urlencoded',
        'Authorization': `Bearer ${accessToken}`
    },
    body: data
})
.then(response => response.json())
.then(json => {
    const { success, data, error } = json

    if (success) {
        const { id } = data
        console.log('New link id', id)
    }

})
.catch(error => console.error(error));

PHP

Curl

Update Link

PUT /v2/organization/:corporation/staff/:username/link/:id

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Url

Name	Type	Description
corporation	number	Corporation ID
username	string	Unique username
id	number	Link ID

Body

Name	Type	Description
name*	string	Link Name
url*	string	Link Url *must be valid url

Response

200

{ 
    data: { 
        id: 1
    }, 
    success: true 
}

Code

Node

const data = new URLSearchParams();
const accessToken = `<ACCESS TOKEN>`

data.append('name', 'My Blog');
data.append('url', 'https://myblog.com');

fetch('https://public-api.expertfile.com/v2/organization/:corporation/staff/:username/link/:id', {
    method: 'PUT',
    headers: {
        'Content-Type': 'application/x-www-form-urlencoded',
        'Authorization': `Bearer ${accessToken}`
    },
    body: data
})
.then(response => response.json())
.then(json => {
    const { success, data, error } = json

    if (success) {
        const { id } = data
        console.log('Updated link id', id)
    }

})
.catch(error => console.error(error));

PHP

Curl

Delete Link

DELETE/v2/organization/:corporation/staff/:username/link/:id

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Url

Name	Type	Description
corporation	number	Corporation ID
username	string	Unique username
id	number	Link ID

Response

200

{ 
    data: { 
        deleted: true, 
        id: 1
    }, 
    success: true 
}

Code

Node

const accessToken = `<ACCESS TOKEN>`

fetch('https://public-api.expertfile.com/v2/organization/:corporation/staff/:username/link/:id', {
    method: 'DELETE',
    headers: {
        'Content-Type': 'application/x-www-form-urlencoded',
        'Authorization': `Bearer ${accessToken}`
    }
})
.then(response => response.json())
.then(json => {
    const { success, data, error } = json

    if (success) {
        const { id } = data
        console.log('Deleted link id', id)
    }

})
.catch(error => console.error(error));

PHP

Curl