Articles in this section

See more

Connect to SpeedyCraft REST API using Devinco Connect

Follow

This article describes the steps involved in connecting to the SpeedyCraft API with Devinco Connect. The SpeedyCraft API uses OAuth2 authorization with Devinco Connect as provider. The API consumer needs an access token to get any data back from the API, and Devinco Connect provides the access token and optionally a refresh token.

API documentation is found here: https://api.speedycraft.devinco.com/swagger
Authentication server url:
Devinco Connect URL for production: https://connect.devinco.com
Devinco Connect URL for stage (used by SpeedyCraft Test API): https://connect-stage.devinco.com

 

Connect to the SpeedyCraft API from Postman, integration service or similar

This is the default method for connecting to SpeedyCraft API.

First, get the access token: Send a POST request to

For the stage environment:
https://connect-stage.devinco.com/Token/GenerateAccessTokenFromCache

For the production environment: 
https://connect.devinco.com/Token/GenerateAccessTokenFromCache

with the following body/payload:

{
  "clientId": 3,
  "subjectId": "<your-subjectId>",
  "apiKey": "<your apiKey>"
}

Please note that for the SpeedyCraft API, always use ClientId = 3 which for the Devinco Connect service means SpeedyCraft. SubjectId and apiKey is provided by Devinco for the user that will run the integration.

When the access token is returned from Devinco Connect, you are ready to use/test the SpeedyCraft API itself. 

Example:

curl --location --request POST 'https://connect-stage.devinco.com/Token/GenerateAccessTokenFromCache\
--header 'Content-Type: application/json' \
--data-raw '{
"clientId": 3, 
"subjectId": "<your subjectId>",
"apiKey": "<your api key>"
}'

 

Send a request to the SpeedyCraft API

NB! Please note that in this request, the clientId is the client within SpeedyCraft which is a GUID provided by Devinco, please do not mix this with the clientid for Devinco Connect (which is 3 for SpeedyCraft).

Example: Get all assignments with a specific customer:

curl --location --request GET 'https://test-api.speedycraft.devinco.com/api/Assignment?page=1&pageSize=50&Filters=CustomerId==30024'  \
--header 'clientId: <Id-provided-by-Devinco>' \
--header 'Authorization: Bearer <your-access-token>'

Related articles