Authenticatie

Voor toegang tot de Partner API is authenticatie met geheime API-sleutels vereist. Genereer en beheer je sleutels via de Partner Console.

API-sleutels zijn je inloggegevens voor toegang tot partnerresources. Elke sleutel heeft beperkte toegang tot specifieke organisatiegegevens en kan indien nodig direct worden gedeactiveerd.

Ga zorgvuldig om met je API-sleutels: ze geven volledige toegang tot je account! Stel deze sleutels nooit bloot in openbare repository's, client-side applicaties of op andere plaatsen waar ze kunnen worden misbruikt.

Authenticeer verzoeken met HTTP Basic Auth door je API-sleutel als gebruikersnaam mee te geven. Laat het wachtwoord leeg.

De API accepteert alleen beveiligde HTTPS-verbindingen. Gewone HTTP-verzoeken worden geweigerd, net als verzoeken zonder geldige authenticatiegegevens.

Voorbeeldverzoek

curl https://partner-api.performancehub.co/partner/v1/organisations \
  -u sk_live_YOUR_PARTNER_SECRET_KEY:
# The colon prevents curl from asking for a password.

Geheime sleutel verifiëren

curl https://partner-api.performancehub.co/partner/v1/auth/ping \
  -u sk_live_YOUR_PARTNER_SECRET_KEY:
# Returns { "message": "You are successfully authorised as <PartnerName>" }