Integrates API Access
A few days ago, we launched a new feature that allows users to make requests directly to our GraphQL API. You can do this by using one of the following methods:
Browser method
1. Log in to https://integrates.fluidattacks.com
2. Open https://integrates.fluidattacks.com/api
3. Open the Settings using the upper-right button
4. Set a new value: "request.credentials": "include"
and save the settings
5. Go to a new tab and make your queries
Note: This method uses the same session as the web application, which lasts for 40 minutes. After that, you need to log in to https://integrates.fluidattacks.com again and refresh the https://integrates.fluidattacks.com/api page.
If you want your session to last more than 40 minutes, you can use an API Token as shown below.
API Token method
1. Generate the API Token from the web application using the API
option in the left panel:
2. Select an expiration date up to six months after the creation date:
3. After clicking the “Proceed” button, you will see a string labeled “Access Token”. This will be your API Token:
4. Store this token safely, as it is the only time you will see it. With it, you can do the same things that you usually do on the Integrates web application.
You can also generate the API Token using the next GraphQL mutation on https://integrates.fluidattacks.com/api, where expirationTime
is a Unix Timestamp
mutation {
updateAccessToken(expirationTime:1577854799) {
sessionJwt
}
}
You will get the API Token under the sessionJwt
value:
Add a new Header in HTTP HEADERS
with the name Authorization
and the value Bearer <api-token>
, where <api-token>
is the token generated in the previous steps:
Done! Now you can make queries with the same API Token for up to six months (depending on the expirationTime
you set earlier):
Resources
- Available queries and mutations are shown in the right panel of the browser:
- GraphQL documentation: https://graphql.org/learn/