Ga naar inhoud

meemoo Organization API V2

Documentation for meemoo's Organization API V2. This API provides access to information about organizations and people within the meemoo context, such as content partners, educational partners, address sites, contact information, account managers, and meemoo personnel. It is a GraphQL API that conforms to the October 2021 specification.

Authentication

This API uses authentication via JSON Web Tokens (JWT). You can request a JWT using your meemoo username and password:

  1. Request a token from QAS or production:

    curl -v -u '<username/email/...>:<password>' "https://oas-qas.meemoo.be/token?grant_type=client_credentials&expires_in=31536000"
    curl -v -u '<username/email/...>:<password>' "https://oas.meemoo.be/token?grant_type=client_credentials&expires_in=31536000"
    
  2. Send the token in the Authorization: Bearer header or in the jwtauth query parameter:

    curl -v https://services-qas.viaa.be/organisation_v2/?jwtauth="eyJ0eXAiOiJKV1......tbjz4-r4"
    curl -v https://services.viaa.be/organisation_v2/?jwtauth="eyJ0eXAiOiJKV1......tbjz4-r4"
    

GET request

A GraphQL GET request contains the GraphQL query in the query query string:

curl -v 'https://services-qas.viaa.be/organisation_v2?query=<graphql_query>'
curl -v 'https://services.viaa.be/organisation_v2?query=<graphql_query>'

POST request

A GraphQL POST request expects a JSON-encoded payload and the Content-Type: application/json header:

{
  "query": "...",
  "operationName": "...",
  "variables": { "myVariable": "someValue" }
}

Testing

The QAS API also serves GraphQL Playground at https://services-qas.viaa.be/organisation_v2. Authentication is required.

Queries

  • contentpartners
  • organizations
  • persons
  • schools

Types

  • Query
  • Boolean
  • Concept
  • ContactPoint
  • ContentPartner
  • IContactPoint
  • ID
  • IOrganization
  • Int
  • Logo
  • OrgType
  • Organization
  • OrganizationalUnit
  • Person
  • Post
  • PostalAddress
  • School
  • Sector
  • Site
  • String

Endpoints

All calls require an Authorization: Bearer <YOUR_TOKEN_HERE> header or the equivalent jwtauth query parameter.

Contact and license

Contact meemoo support or visit meemoo.be. The API documentation is licensed under the Apache License 2.0.