Få Live DoCAS kursusdata på din hjemmeside, med det nye DoCAS API

Hvis du benytter DoCAS kursusadministration til at administrere dine kursusaktiviteter, får du nu langt større frihed til at præsentere dit kursuskatalog på din hjemmeside. Med DoCAS API bestemmer du selv, hvordan du præsenterer dine aktiviteter i forhold til informationer, farver, fonte og så videre.

Baggrund

Det har altid været muligt i DoCAS at bruge Widgets til at få vist kursusdata på egen hjemmeside. Dette er en nem og hurtig måde at få vist sit kursuskatalog på hjemmesiden, og selv om der er mange muligheder for at indstille udseendet (se nedenfor), er opsætningen stadig begrænset af en fast skabelon. DoCAs Widget Setup

DoCAS API

Vi har udviklet DoCAS API, og stiller det frit til rådighed for vore Maxi og Enterprise kunder. API er en forkortelse for Application Programming Interface, API’et gør det muligt for forskellige programmer at ”tale” sammen. Med DoCAS API’et kan du trække dine aktivitetsdata “ud af DoCAS”, og bruge dem, som du ønsker det, i andre løsninger, f.eks. på din hjemmeside.

Hvordan kommer jeg i gang?

Vores API er beskrevet på http://docas.dk/api, hvor du finder tekniske informationer til, hvordan du kommer i gang.

1. Undersøg om dit abonnement er DoCAS Maxi eller DoCAS Enterprise.

Log ind i DoCAS, og tjek hvad der står ud for dit konto navn i topmenuen abonnement type Hvis dit abonnement ikke er Maxi, kan du opgradere ved at klikke på dit kontonavn, og vælge “Opgradér til Maxi”. upgrade

2. Hent din API kode

Log ind i DoCAS, klik på dit kontonavn, og vælg “API indstillinger” apiindstillinger På “API Indstillinger” kan du hente den kode, du skal bruge i dine API kald. De koder som du skal bruge, er dit Vendor ID og  Read Only API key apidetaljer

3. Begynd at hente data

Med disse koder kan du nu begynde at hente data, f.eks. vil dette kald: http://docas.dk/api/courses/56e7c52f-32c8-4f6b-9ae8-4da7463ab2cd/49307ff0-edf4-48c1-b7a0-a45000e9df5f?format=jsonp Hente alle aktive kurser fra vores testskole “Bager- og konditorskolen”, og returnere dem som json. Udførlig vejledning kan findes på: http://docas.dk/api

4. Eksempel på kursusliste

Her er et simpelt eksempel, hvor kursusdata hentes fra DoCAS og skrives ud på egen hjemmeside.

   <!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
    <title></title>
    <script src="Scripts/jquery-1.9.1.js"></script>
    <style>
        table {
            font-family: verdana,arial,sans-serif;
            font-size: 11px;
            color: #333333;
            border-width: 1px;
            border-color: #666666;
            border-collapse: collapse;
        }

        th {
            border-width: 1px;
            padding: 8px;
            border-style: solid;
            border-color: #666666;
            background-color: #dedede;
        }

        td {
            border-width: 1px;
            padding: 8px;
            border-style: solid;
            border-color: #666666;
            background-color: #ffffff;
        }
    </style>
</head>
<body>
    <div id="container">
        <h3>Alle kurser</h3>
        <table id="allekurser">
            <tr>
                <th>Navn</th>
                <th>Startdato</th>
                <th>Slutdato</th>
                <th>Undervisernavn</th>
                <th>Stednavn</th>
                <th>Lokale</th>
                <th>Pris</th>
                <th>Antal pladser</th>
            </tr>
        </table>
        <h3>Et kursus</h3>
        <table id="etkursus">
        </table>
    </div>
    <div id="test"></div>
    <script>
        $(document).ready(function () {
            $.getJSON("http://docas.dk/api/courses/
                       56e7c52f-32c8-4f6b-9ae8-4da7463ab2cd/
                       49307ff0-edf4-48c1-b7a0-a45000e9df5f?callback=?", 
             function (result) {
                
                for (var i = 0; i < result.length; i++) {
                    var name = "<td>" + result[i].name + "</td>";
                    var start = "<td>" + result[i].start + "</td>";
                    var slut = "<td>" + result[i].end + "</td>";
                    var underviser = "<td>" + result[i].instructorName + "</td>";
                    var sted = "<td>" + result[i].locationName + "</td>";
                    var lokale = "<td>" + result[i].locationRoom + "</td>";
                    var pris = "<td>" + result[i].price + "</td>";
                    var pladser = "<td>" + result[i].maxParticipants + "</td>";
                    $("#allekurser").append("<tr>" + name + start + 
                    slut + underviser + sted + lokale + pris + pladser + "</tr>");
                }
            });

            $.getJSON("http://docas.dk/api/course/
                       56e7c52f-32c8-4f6b-9ae8-4da7463ab2cd/
                       49307ff0-edf4-48c1-b7a0-a45000e9df5f/
                       581c604f-aa74-4b39-9dbd-a45100e8fd54?callback=?", 
               function (result) {                
                $.each(result, function (key, value) {
                    $("#etkursus").append("<tr><td>" + key + "</td>" + 
                    "<td>" + value + "</td>/tr>");
                });
            });
        });

    </script>
</body>
</html>


Se siden her: http://docas.dk/api/courses.html

– Christian Tilsted

Skriv et svar

Din e-mailadresse vil ikke blive offentliggjort. Krævede felter er markeret med *

Disse HTML koder og attributter er tilladte: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong>