Artikeln förklarar hur jag som kund eller partner kan göra API anrop för att hämta eller skicka data till Mediaflow.
Vår API dokumentation finns här
Använd vårt färdiga integrations kit (Javascript version) - Rekommenderat
Vårt färdiga integrations kit (äldre iFrame version)
Nycklar
Kontakta supporten för att komma åt de kundspecifika nycklar som behövs för kopplingen.
Notera att aktuellt avtal påverkar huruvida arbete med API tillåts eller inte.
Exempel:
client_id: e2b902ds1
client_secret: g75AhbS8sgDtysjSeysi74shxXiokSH
refresh_token: KNXRDVbtNvpA2uqQwqIaop9OPxRBXQ8
Anrop för att få tillgång till API:t
Gör ett anrop till endpointen med hjälp av nycklarna ovan.
URL mönster:
GET: https://customerapi.mediaflowpro.com/1/oauth2/token?grant_type=refresh_token&client_id={client_id}&client_secret={client_secret}&refresh_token={refresh_token}
Exempel:
https://customerapi.mediaflowpro.com/1/oauth2/token?grant_type=refresh_token&client_id=e2b902d1&client_secret=g75AhS8sgDtysjSeysi74shxXxiokSH&refresh_token=KNXRDVtNvpA2uqQwqIaop9OPxRBXQ8
Svar på ovan
Som svar får du en access_token som används sedan i API anropen till våra dokumenterade endpoints.
Exempel:
{
“access_token”:"eyJhbGciOiJIUbzI1NiIsInR5cCI6IkpXcVCJ9.eyJzZXJ2IjoiMTciLCJzdWIiOiI1NDM5IiwiZXhwIjoxNTgxMzQ5NTczLCJpZGN1c3QiOiI0NjgiLCJzY29wZXMiOlsiMiIsIjkiLCI2NjAyMjAiLCIwIiwiMCJdfQ.drjHwqCD9IT-w_bB0DUp9JokK7wLPrb9_7ccrfwCGNw”,
"token_type":”Bearer",
“expires_in”:7200
}
Detta är JSON data. access_token här har värdet:
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzZXJ2IjoiMTcibLCJzdWIiOiI1NDM5IiwiZXhwIjoxNTgxMzQ5NTczLCJpZGN1c3QiOiI0NjgiLCJzY29wZXMiOlsiMiIsIjkiLCI2NjAyMjAiLCIwIiwiMCJdfQ.drjHwqCD9IT-w_bB0DUp9JokK7wLPrb9_7ccrfwCGNw
Dataanrop till API
Exempel
Värdet på variabeln “access_token” kan sedan användas i exempelvis följande GET anrop.
GET: https://customerapi.mediaflowpro.com/1/file/latest?processed=true&page=1&per_page=4&type=image&fields=id,name,filename,hasPreview,icon,smallPreview,mediumPreview,width,height,type&access_token={access_token}
Byt ut värdet på {access_token} till det du fick som svar ovan . Du kommer då få ett json svar som ser ut som följande. Exempel svaret nedan innehåller all information om de senaste 4 upladdade bilderna.
[
{
"id":539420,
"name":"prispall",
"filename":"prispall.jpg",
"type":{
"id":101,
"type":"image",
"description":"JPEG-bild",
"extension":"jpg"
},
"width":960,
"height":540,
"hasPreview":true,
"icon":"https://static.mediaflowpro.com/images/icon101.gif",
"smallPreview":"https://im17.inviewer.se/info/54/54ATNEZ6I4.jpg",
"mediumPreview":"https://im17.inviewer.se/skiss/54/54ATNEZ6I4.jpg"
} …
]
Ladda upp en fil
Exempel
POST /1/file
{
"filename": "Image01.jpg",
"filesize": 1564256,
"toFolder": FOLDERID
}
Nu får man en uploadURL som svar från API:et. Ladda då upp filen via xhr upload dit. uploadURL fungerar i 10 min.
{
"expiresIn": 600,
"uploadURL": "https://ftp5.inviewer.se/up/..."
}
Om användaren som är kopplad till api-nyckeln inte har rättighet att ladda upp till den angivna mappen får man:
{
"status": 403,
"error": "You don´t have permission to upload to this folder"
}