Media Appearances

CRUD endpoints for a user's media appearances

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

Get All Media Appearances

GET /v2/organization/:corporation/expert/:username/mediaappearance

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,
    title: 'Appearance Title',
    organization: 'Appearance Org.',
    type: 'online',
    url: 'Url',
    details: 'Appearance Details',
    date:'',
    cover_url: 'Uploaded Img url,
    large_cover_url: 'Uploaded Img url',
    cover_alt_title: 'Uploaded Img alt'
    },
  ],
  success: true
}

Code

Node

const accessToken = `<ACCESS CODE>`

fetch('https://public-api.expertfile.com/v2/organization/:corporation/expert/:username/mediaappearance', {
    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 media = data;
        console.log('all media', media)
    }

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

PHP

Curl

Get Individual Media Appearances

GET /v2/organization/:corporation/expert/:username/mediaappearance/: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	Media Appearance ID

Response

200

{
  data: [
    {
    id: 1,
    title: 'Appearance Title',
    organization: 'Appearance Org.',
    type: 'online',
    url: 'Url',
    details: 'Appearance Details',
    date:'',
    cover_url: 'Uploaded Img url,
    large_cover_url: 'Uploaded Img url',
    cover_alt_title: 'Uploaded Img alt'
    },
  ],
  success: true
}

Code

Node

const accessToken = `<ACCESS CODE>`

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

    if (success) {
        console.log('media', data)
    }

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

PHP

Curl

Create Media Appearances

POST /v2/organization/:corporation/expert/:username/mediaappearance

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
title*	string	Appearance Title
organization*	string	Appearance Organization
details*	string	Appearance Details
url	string	Appearance Url
date	unix timestamp	Appearance Date
type	string	Appearance Type(this can be one of 'print', 'online', 'tv', 'radio')

Response

200

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

Code

Node

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

data.append('title', 'My Appearance Title');
data.append('organization', 'My Appearance Name...');
data.append('details', 'My Appearance Details');
data.append('url', 'https://url.com')
data.append('type', 'online')
data.append('date', 1341892800);

fetch('https://public-api.expertfile.com/v2/organization/:corporation/expert/:username/mediaappearance', {
    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 media id', id)
    }

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

PHP

Curl

Update Media Appearances

PUT /v2/organization/:corporation/expert/:username/mediaappearance/: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	Appearance ID

Body

Name	Type	Description
title*	string	Appearance Title
organization*	string	Appearance Organization
details*	string	Appearance Details
url	string	Appearance Url
date	unix timestamp	Appearance Date
type	string	Appearance Type(this can be one of 'print', 'online', 'tv', 'radio')

Response

200

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

Code

Node

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

data.append('title', 'My Appearance Title');
data.append('organization', 'My Appearance Name...');
data.append('details', 'My Appearance Details');
data.append('url', 'https://url.com')
data.append('type', 'online')
data.append('date', 1341892800);

fetch('https://public-api.expertfile.com/v2/organization/:corporation/expert/:username/mediaappearance/: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('New media id', id)
    }

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

PHP

Curl

Delete Media Appearances

DELETE /v2/organization/:corporation/expert/:username/mediaappearance/: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	Appearance 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/expert/:username/mediaappearance/: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 media id', id)
    }

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

PHP

Curl