Graph API Authorization
Graph API requests are performed with the integration access token. Integration access tokens are unique for each connection you have to a district or university through Edlink. Adding an integration access token to your request headers will return data specific to that integration. You can only recieve data for a single integration at a time per request.
Locating Integration Access Tokens
You can find integration access tokens on the Edlink Dashboard by clicking on any active integration and copying from the integration summary. Additionally it is possible to programmatically access your integration access tokens by using the Meta API endpoint documented here. Accessing integrations programmatically can be very useful, particularly at scale.
Some important notes about integration access tokens:
- They do not expire.
- They are not tied to a specific user.
- They are not intended to be used by end users. They are intended to be used by your backend systems. Do not expose them on the frontend.
- They will only work while your integration state is
activeorpaused. - If you intend to making write requests from the Graph API to be sure to make necessary permissions checks.
If you believe your integration access token has been compromised contact us immediately.
Making Requests With Integration Access Tokens
Using the integration access token is like any other Bearer token API. Add the token to the authorization header of your request prefixed with Bearer .
Integration access tokens do not expire, so you do not need to worry about refreshing them.
Example Request
axios.get('https://ed.link/api/v2/graph/people', {
headers: {
authorization: `Bearer ${integration_access_token}`
}
});
