# JCNetwork Certificaton API

[TOC]

## Die Schnittstelle

Die Schnittstelle an sich ist unter https://certification.jcnetwork.de/api/ zu erreichen und stellt die Daten m JSON Format bereit, mit dem du weitere Auswertungen durchführen kannst.

## Token erstellen

Suche im [Certification Portal](https://certification.jcnetwork.de/oauth.php) den Tab Weiterbldungsbeauftragter und klicke dort auf den Unterpunkt "API Anbindung für Vereine".

Dort kommst du auf die Folgende Seite auf der du bequem deinen Applikationstoken erstellen kannst, mit dem du später auf die API zugreifen kannst.

Einmal erstellt solltest du den Token sofort speichern, da du im Nachgang nicht mehr darauf zugreifen kannst. Du kannst jedoch jederzeit neue Tokens anlegen.


Du siehst auf dieser Seite zudem eine Übersicht über alle bereits generierten Tokens und kannst diese auch wiederrufen bzw. löschen. Damit hast du zu jederzeit die volle Kontrolle.

## Erste Verbindung

Um den von dir generierten Token zu testen können wir nun die Anfrage `https://certification.jcnetwork.de/api/?token=<<yourToken>>` an die Schnittstelle anfragen, die Antwort gibt aus ob der Token valide ist, oder ein Fehler aufgetreten ist. Sollte ein Fehler auftreten, lösche den Token und versuche einen neuen Token zu erstellen.

:::info
Bei jeder Anfrage an die API musst du dich mit dem Token validieren, der Token ist also fester Bestandteil jeder einzelnen Anfrage.<br>
`?member=true&andereAttribute=1&token=<<yourToken>>`
:::

## Mitglieder auflisten

Alle Mitgliederdaten kannst du über die Flag `member=true` erreichen. Es werden nun alle Mitglieder deines Vereins aufgelistet und es stehen folgende Attribute zur Weiterverarbeitung zur Verfügung:

- ID
- Nutzername
- Vorname
- Nachname
- Email welche im Certification Portal hinterlegt wurde
- Zertifizierungsstatus des alten CJC
- Zertifizierungsdatum des alten CJC
- Aktivitätsstatus laut System (wurden in den letzten 2 Jahren Schulungen oder Workshops besucht, oder Praxiserfahrung gesammelt)
- Zertifizierung als JCNetwork Certified Junior Consultant
- Zertifizierungsdatum als JCNetwork Certified Junior Consultant

Jeder Datensatz besteht dabei aus dem hier aufgeführten Format, mehrere Datensätze werden dabei als Array hintereinander ausgegeben.

> Ein Beispiel-Datensatz:
`{
"id": "123",
"username": "angela.merkel",
"name": "Merkel",
"firstname": "Angela",
"email": "[e-mail]",
"certified": "1",
"certified_at": "2014-11-03",
"active": "1",
"certified_new": "1",
"certified_new_at": "2017-11-18"
}`

## Mitglieder filtern

## Schulungsinformationen je Mitglied

## Praktische Erfahrung je Mitglied

# Die Daten im Verein nutzen