Voorgestelde trefwoorden
Gerelateerde artikelen
Gerelateerde cases
Gerelateerde downloads
Alle resultaten
Voorgestelde trefwoorden
Gerelateerde artikelen
Gerelateerde cases
Gerelateerde downloads
Alle resultaten

Building CMNTY Integrations Using the API

06-07-2017

If you are a software developer then the word API probably doesn’t need an introduction. However, if you are not that tech savvy, but are interested in connecting your community platform with other systems, then you’ll be happy to know that CMNTY Platform is now capable of that. There are so many other great SaaS tools out there that open up an entire world of possibilities when connected to a community of customers, employees or partners. Therefore, the release of our new community API integration marks the starting point of a new era. 

What Is an API?

An Application Programming Interface (API) is a bridge that allows 2 systems to interact with each other while exchanging data. Our platform featured a private API for custom projects before, but because we wanted to offer a public API we decided that the old implementation wasn’t suited for that. Therefore, this is the reason behind why we have started rewriting it from scratch over the past months to accomodate for our own and our customer’s wishes. The result? An implementation that is ready for the future!

Exchanging Data

Using the API you can now connect or integrate your community platform with other systems. It works by sending data to it over HTTPS. If you don’t know how to do this, it’s best you consult your IT team.

You start by authenticating yourself and once that is successful you can start sending and retrieving data through the Application Programming Interface. Please be advised that the current implementation is part of our Premium plan.

How to Configure and Get Started

The API requires (almost) zero configuration of your Platform. However, you have to make sure that you set some defaults in the request. Here are the most important ones:

Basic Auth

First of all you need to be authenticated. It is not possible to connect to the Application Programming Interface without proper authentication. For authentication the platform uses Basic Auth. You can create a new application under Configure -> API. Once you have done that you will receive a token from the Platform, which you can use to authenticate yourself.

API Version

We also highly recommend you set the version of the API for any request you do. We will perform regular updates to the Application Programming Interface and to avoid that your application stops working we will “version” the API.

Content-type

Lastly it’s important to set the content type. For now platform only returns the JSON format. Your request headers will look like this:


Accept: application/vnd.cmnty.v1+json
Content-type: application/json
Authorization: Basic aHR0cHdhdGNoOmY=

Be sure to also have a look at our support article on how to setup the Application Programming Interface.

“User” and “Invite” End-points

For now our Application Programming Interface supports two “End-points” or methods. An end-point gives you access to a certain type of platform data or can trigger certain actions.

Users

Currently you can perform the following actions: Get Users, Get User (single), Delete a User and Get User groups. For example, you can get the first user of the platform by calling:


GET https://bagelsandfriends.cmnty.com/api/user/users/1

and your output will look similar to this:


{
"id": 123,
"username": "jack",
"email_address": "hello@example.org",
"language": "en",
"role": {
"id": 123,
"name": "Community Manager",
"key": "community-manager"
},
"status": "active",
"profile_url": "https://../user/profile/{id}/{username}",
"avatar_url": "https://../avatar.png",
"self": "https://../api/user/users/{id}",
"created_at": "2017-02-28T09:39:33+00:00",
"updated_at": "2017-02-28T09:39:33+00:00",
"logged_in_at": "2017-02-28T09:39:33+00:00",
"last_activity_at": "2017-02-28T09:39:33+00:00"
}

Invites

Consequently, you will have control over the invite system of the platform. The following end-points are available: Get Invites, Create New Invite, Get Invite (Single), Update an Invite, Delete an Invite, Send an Invite, Get Invite Groups.

Roadmap

The above describes our first release of our new API. In the following quarters we will be further expanding the capabilities of this Application Programming Interface based on customer feedback and our internal roadmap. In the meantime, be sure to consult our help center.

 

Feedback

Wij geven om jouw privacy

Wij en derden gebruiken cookies op onze website. We gebruiken cookies voor statistische, voorkeur- en marketingdoeleinden. Google Analytics cookies zijn geanonimiseerd. Je kunt je voorkeuren wijzigen door op ‘Verander opties’ te klikken. Door op ‘Accepteren’ te klikken accepteer je het gebruik van alle cookies zoals beschreven in onze privacy-statement.

Powered by WP Brothers

Kies je privacyvoorkeuren

Via de cookieverklaring op onze website kun je jouw toestemming op elk moment wijzigen of intrekken. In ons privacybeleid vind je meer informatie over wie we zijn, hoe je contact met ons kunt opnemen en hoe we persoonlijke gegevens verwerken.

Noodzakelijk

Noodzakelijke cookies helpen onze website bruikbaarder te maken, door basisfuncties als pagina-navigatie en toegang tot beveiligde gedeelten van de website mogelijk te maken. Zonder deze cookies kan de website niet naar behoren werken.

Voorkeuren

Voorkeurscookies zorgen ervoor dat de website informatie kan onthouden die van invloed is op het gedrag en de vormgeving van de website, zoals de taal van je voorkeur of de regio waar je woont.

Statistieken

Statistische cookies helpen ons begrijpen hoe de website wordt gebruikt, door anoniem gegevens te verzamelen en te rapporteren. Met deze informatie kunnen wij onze site blijven verbeteren voor optimaal gebruik.

Marketing

Marketingcookies gebruiken we om relevante content en advertenties te tonen op andere websites die je bezoekt, die zijn toegespitst op jouw interesses.