Aatop REST API handleiding

Aatop REST API handleiding

Vacature API - Gebruikersdocumentatie 

Introductie

Deze API maakt het mogelijk om vacatures veilig te toevoegen, bijwerken of verwijderen op de website van Aatop ICT. Elke actie vereist een geldige API-sleutel.

Content type

De gestuurde gegevens moeten van het content-type application/json zijn. Neem dit mee in de header:

Content-type: application/json 

Authenticatie

Alle verzoeken moeten worden geauthenticeerd met een geldige API-sleutel, meegegeven via de Authorization header:

Authorization: Bearer ontvangen-api-key

Vacature toevoegen of bijwerken

Endpoint: POST https://website.nl/wp-json/vacatures/v1/sync

Stuur een JSON object met de vacaturegegevens. Als de vacature al bestaat (gebaseerd op id), dan wordt deze bijgewerkt.

Voorbeeld aanvraag

{
  "id": "20536",
  "functie": "Jouw volgende stap in de IT!",
  "metatitle": "Meta titel voor SEO",
  "metadescription": "Korte omschrijving voor SEO",
  "plaats": "Regio Dordrecht",
  "vestiging": "ICT",
  "accountmanager": "Dhr. T.D. Baboeram",
  "telefoonnummer": "(0184) 620 820",
  "emailadres": "t.baboeram@aatop.nl",
  "datumop": "2025-09-15 00:00:00",
  "datumvan": "2025-12-31 00:00:00",
  "salarisVan": "2500",
  "salarisTot": "6000",
  "urenVan": "32",
  "urenTot": "40",
  "organisatie": "Aatop ICT",
  "logolink": "https://example.com/logo.png",
  "videolink": "https://example.com/video.mp4",
  "slogan": "
Korte introductietekst
",
  "blokken": [
    {
      "Titel": "Werkzaamheden",
      "Inhoud": "
Je gaat werken aan...
",
      "Sorteer": 0
    }
  ],
  "seo": ["IT projectmanager"],
  "categorie": [["Support"]],
  "niveau": [["MBO"]],
  "regio": ["Zuid-Holland"],
  "werkervaring": ["2 – 10 jaar ervaring"],
  "dienstverband": [["In dienst bij opdrachtgever"]]
}

Voorbeeld response

{
  "status": "success",
  "post_id": 123
}

Vacature verwijderen

Endpoint: DELETE https://website.nl/wp-json/vacatures/v1/sync/<id>

Hierbij is <id> het unieke vacature-ID zoals in het JSON object (bijv. 20536).

Voorbeeld:

DELETE https://website.nl/wp-json/vacatures/v1/sync/20536

Voorbeeld response:

{
  "status": "deleted",
  "post_id": 123
}

Belangrijke velden

  • id (vereist): Uniek extern ID van de vacature
  • functie (vereist): Titel van de vacature
  • seo, niveau, regio, etc.: Arrays met bestaande termen
  • blokken: Inhoudelijke secties (20 max), bestaande uit Titel, Inhoud, Sorteer

Ondersteuning

Bij vragen of voor het ontvangen van een geldige API-key, neem contact op via helpdesk@teqz.nl.

    • Related Articles

    • Handleiding WordPress 5.x

      Download hier een gebruikershandleiding voor WordPress 5.x. In deze handleiding gaan we uit van het gebruik van Custom velden, dus niet van de standaard Editor of Gutenberg.  Mis je zaken in deze handleiding of zitten er onjuistheden in? Laat dit ons ...

    • Instellen e-mail op iPhone en iPad

      Hoe kan ik e-mail instellen op een iPhone / iPad? Wat heb ik nodig om e-mail in te stellen op een iPhone / iPad 1. Het domein welke u graag wilt instellen dient gekoppeld te zijn met uw hosting pakket en de domeinnaam dient via internet bereikbaar te ...