> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tapify.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Workspace ophalen

> Controleer je API-sleutel en de workspace waartoe deze toegang geeft.

Gebruik dit endpoint voor je eerste verzoek. Het geeft de ID van de sleutel terug en de ID, naam en het eigen domein van de workspace. `domain` is `null` als er geen eigen domein is ingesteld.

Het antwoord beschrijft de workspace, niet een individuele gebruiker. Controleer dit voordat je gegevens importeert of wijzigt.

> [!NOTE]
>
> Elke API-sleutel hoort bij één workspace. Wil je een andere workspace koppelen? Maak daar een sleutel aan en gebruik die voor verzoeken aan die workspace.


## OpenAPI

````yaml nl/api-reference/openapi.json GET /me
openapi: 3.0.3
info:
  title: Tapify API
  version: 1.0.0
  description: >-
    Lees en beheer opgeslagen contacten, teamleden en hun digitale
    visitekaartjes in één Tapify Teams-workspace. Vereist Teams Connect-toegang
    en een API-sleutel voor de workspace.
servers:
  - url: https://tapify.app/api/v1
    description: Tapify API
security:
  - bearerAuth: []
  - apiKeyHeader: []
tags:
  - name: Workspace
    description: Controleer de workspace die aan een API-sleutel is gekoppeld.
  - name: Teamleden
    description: Beheer teamleden en hun digitale visitekaartjes.
  - name: Contacten
    description: Beheer contacten die in de workspace zijn verzameld.
  - name: Zapier
    description: >-
      Endpoints die de Tapify-integratie met Zapier gebruikt voor
      triggervoorbeelden en REST Hook-abonnementen.
paths:
  /me:
    get:
      tags:
        - Workspace
      summary: Workspace ophalen
      description: >-
        Controleert de API-sleutel en geeft de workspace terug waartoe deze
        toegang geeft.
      operationId: getWorkspace
      responses:
        '200':
          description: Workspacegegevens
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkspaceResponse'
              example:
                data:
                  apiKeyId: 4c69681a-02d9-4c73-8c21-6d4489c0879f
                  workspace:
                    id: 9df81bd4-3d76-42cc-9518-a019ea75a221
                    name: Acme
                    domain: card.acme.com
        '401':
          $ref: '#/components/responses/Unauthorized'
        '402':
          $ref: '#/components/responses/SubscriptionRequired'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/InternalError'
components:
  schemas:
    WorkspaceResponse:
      type: object
      required:
        - data
      properties:
        data:
          type: object
          required:
            - apiKeyId
            - workspace
          properties:
            apiKeyId:
              type: string
              format: uuid
              description: Id van de API-sleutel die voor dit verzoek is gebruikt.
              example: 4c69681a-02d9-4c73-8c21-6d4489c0879f
            workspace:
              $ref: '#/components/schemas/Workspace'
    Workspace:
      type: object
      description: De workspace die aan de API-sleutel is gekoppeld.
      required:
        - id
        - name
        - domain
      properties:
        id:
          type: string
          format: uuid
          description: Unieke workspace-id.
          example: 9df81bd4-3d76-42cc-9518-a019ea75a221
        name:
          type: string
          example: Acme
        domain:
          type: string
          nullable: true
          description: Eigen domein voor digitale visitekaartjes, als dit is ingesteld.
          example: card.acme.com
    ErrorResponse:
      type: object
      description: Informatie over een verzoek dat Tapify niet kon voltooien.
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
              description: Korte code die de fout aangeeft.
              example: bad_request
            message:
              type: string
              description: Begrijpelijke uitleg van wat er misging.
              example: Request body is invalid.
            details:
              type: object
              description: >-
                Aanvullende informatie die kan helpen om het verzoek te
                corrigeren.
              additionalProperties: true
              nullable: true
  responses:
    Unauthorized:
      description: De API-sleutel ontbreekt, is onjuist of is verwijderd.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            error:
              code: invalid_api_key
              message: API key is invalid or revoked.
    SubscriptionRequired:
      description: >-
        De workspace heeft Teams Connect-toegang nodig. Controleer het
        abonnement, de abonnementsstatus en de einddatum van de proefperiode.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            error:
              code: subscription_required
              message: Tapify Teams Connect is required for this feature.
    NotFound:
      description: Het opgevraagde item bestaat niet in deze workspace.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            error:
              code: not_found
              message: Contact was not found.
    RateLimited:
      description: Er zijn te veel verzoeken in korte tijd verstuurd.
      headers:
        Retry-After:
          description: Aantal seconden dat je moet wachten voordat je het opnieuw probeert.
          schema:
            type: integer
            example: 30
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            error:
              code: rate_limited
              message: Rate limit exceeded.
              details:
                retryAfter: 30
    InternalError:
      description: Tapify kon het verzoek niet voltooien.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            error:
              code: internal_error
              message: Something went wrong.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Tapify API key
      description: API-sleutel die is gemaakt via Instellingen → API-sleutels.
    apiKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key
      description: >-
        Alternatief voor Authorization: Bearer. Gebruik één authenticatiemethode
        per verzoek; een Bearer-token heeft voorrang.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.