Aan de slag
Je app
Waar de eigen applicatie van een bedrijf zich bij 1plek meldt — de verbinding per omgeving, de webadressen en de API-sleutels.
Heeft een bedrijf een eigen applicatie — een webshop, een cursusplatform, een portaal — dan ontmoeten die twee elkaar op één plek: Console → een bedrijf → Je app.
Daar staat alles wat 1plek van die app moet weten, en verder niets:
- de verbinding per omgeving — waar 1plek de app bereikt, waarmee het zich meldt, en wat het daar mag;
- de webadressen van het merk;
- de API-sleutels waarmee de app 1plek aanroept.
Wat hier bewust níét staat
Betaalinstellingen, advertenties en de rest van de instellingen van je applicatie beheer je in die applicatie zelf. 1plek is geen tweede beheerpaneel voor jouw app; het bewaart alleen wat het nodig heeft om ermee te práten.
Dat is een keuze, geen gemis. Een instelling die je op twee plekken kunt zetten, staat vroeg of laat op twee waarden — en dan is de vraag "welke geldt er nu?" niet meer te beantwoorden.
De mail-instellingen waarmee 1plek namens een merk verstuurt, zijn iets anders: die staan bij Console → bedrijf → Instellingen, tabblad Verzending.
De verbinding per omgeving
De meeste organisaties draaien hun app meer dan één keer: productie voor echte klanten, en daarnaast een stage- of ontwikkelomgeving. Dat zijn verschillende databases met verschillende sleutels, dus je zet ze hier naast elkaar — één rij per omgeving.
| Veld | Wat het is |
|---|---|
| Naam | Hoe de omgeving in de kiezer heet, bijvoorbeeld Productie of Stage |
| Sleutel | Vaste naam die je app terugkrijgt, bijvoorbeeld production of staging |
| Productie-omgeving | Aan = echte klanten en echt geld |
| Adres | Waar 1plek deze omgeving bereikt |
| Service-sleutel | Waarmee 1plek zich meldt bij die omgeving |
| Wat deze omgeving aanbiedt | Welke onderdelen 1plek hier mag beheren |
Geef elke omgeving zijn eigen service-sleutel. Eén sleutel voor alles betekent dat een lek op stage ook je productie-omgeving opent.
Zolang je hier niets invult, gebruikt 1plek de verbinding die op de server is ingesteld. Zodra je je eerste omgeving toevoegt, neemt deze lijst het over — zet er dan in één keer alles neer wat je nodig hebt.
Wanneer iets als productie telt, en hoe je een testomgeving vult met een kopie van een andere, staat bij Omgevingen en synchroniseren.
Webadressen
Een administratieve lijst van de site-adressen van dít merk. Het primaire adres is
waar terug-links naartoe wijzen — in mails, in profielen. De rest zijn aliassen: de
www-variant, een testomgeving.
Het adres van je wérkruimte hoort niet in dit lijstje. Dat is er één voor de hele organisatie, niet per merk.
Een adres hier toevoegen richt niets in. Er wordt geen DNS gecontroleerd en geen certificaat aangevraagd — dat regel je waar je site draait.
API-sleutels
Hiermee roept jouw app 1plek aan. Een sleutel hoort bij één bedrijf, wordt gehasht opgeslagen en is na het aanmaken niet meer op te vragen: je ziet 'm één keer.
| Recht | Waarvoor |
|---|---|
company:read | De contactgegevens en social links van het merk ophalen |
events:write | Melden dat er iets gebeurd is, zodat 1plek het bericht verstuurt |
Wat je app daarmee kan, staat bij Je app koppelen en Gebeurtenissen melden via de API.
Ook hier geldt: een sleutel per omgeving. Je testomgeving hoort niet met dezelfde sleutel te schrijven als je productie-app.
Geheime waarden
Sleutels en tokens worden nooit teruggegeven aan je scherm. Je ziet alleen of een veld is ingevuld, met stipjes.
- Een leeg geheim veld betekent "niet wijzigen" — niet "wissen". Wil je een sleutel vervangen, vul dan de nieuwe in.
- Na het opslaan zegt de bevestiging welke geheimen zijn vervangen. Zegt hij "ongewijzigd", dan is er niets meegegaan en staat de oude sleutel er nog.
Wijzigen wordt vastgelegd: wie het deed, welke velden, en bij welke omgeving. De waarden zelf komen daar niet in.
Wie mag dit?
Dit is beheer van een bedrijf, dus je hebt de sectie Je app nodig bij dat bedrijf; zie Toegang en rechten. Het adres of de service-sleutel van een omgeving wijzigen is voorbehouden aan een beheerder van de organisatie — daarmee verleg je namelijk waar élke beheeractie landt.
Als iets niet werkt
- Er is geen omgeving om te kiezen. Dan is er voor dit bedrijf nog niets ingericht, of de omgeving die je koos heeft geen adres.
- Opslaan lukt niet en je krijgt een uitleg over een draaiende winkel. Dan probeerde je iets te doen dat alleen op een testomgeving mag. Kies bovenaan een testomgeving.
- Je hebt opgeslagen maar er verandert niets. Kijk naar de bevestiging: stond daar "geheime velden ongewijzigd", dan was het veld leeg en is de oude waarde blijven staan.