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:
-
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" -
Send the token in the
Authorization: Bearerheader or in thejwtauthquery 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¶
Types¶
QueryBooleanConceptContactPointContentPartnerIContactPointIDIOrganizationIntLogoOrgTypeOrganizationOrganizationalUnitPersonPostPostalAddressSchoolSectorSiteString
Endpoints¶
- Production: https://services.viaa.be/organisation_v2
- QAS: https://services-qas.viaa.be/organisation_v2
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.