Welcome on API reference page. Here You can find queries/mutations for service2service integration.

Authorization

All requests to this API require an API token sent in Authorization header in format TOKEN {token}. You can obtain it in workspace detail.

Creating pass

To create new pass You need to know Project ID and Template ID (see below how to fetch list of projects/templates). You can also provide ID of a pass (so You can use Your own identifier). When pass with given ID exists, it's updated (no need to use updatePass method).

You can send following request:

curl --request POST \
  --url 'https://api.tiketo.eu/graphql' \
  --header 'authorization: TOKEN {YOUR_TOKEN_HERE}' \
  --header 'content-type: application/json' \
  --data '{"variables":{"projectId":"{PROJECT_ID}","input":{"templateId":"{TEMPLATE_ID}","parameters":"{\"firstName\":\"John\",\"lastName\":\"Doe\"}"}},"query":"mutation CreateOrUpdatePass( : ID!, : ID, : PassInput!) { createPass( projectId: $projectId, id: $id, input: $input) { share { url expiration } } }","query2":"query ($projectId: ID!,$filename: String!) { token { project( id: $projectId) { file(name: $filename) { uploadUrl } } } }"}'

API response:

You will receive create pass in response:

{"data":{"createPass":{"share":{"url":"https://...","expiration":"2021-12-31T23:59:59Z"}}}}

Fetching data

List of Projects

Project represents a group of passes. You can fetch list of projects using following query:

curl --request POST \
  --url 'https://api.tiketo.eu/graphql' \
  --header 'authorization: TOKEN {YOUR_TOKEN_HERE}' \
  --header 'content-type: application/json' \
  --data '{"query":"query GetProjects { projects { id name } }"}'

API response:

You will receive create pass in response:

{"data":{"projects":[{"id":"...","name":"..."}]}}

List of PassTemplates

Template represents a pass design. You can fetch list of templates using following query:

curl --request POST \
  --url 'https://api.tiketo.eu/graphql' \
  --header 'authorization: TOKEN {YOUR_TOKEN_HERE}' \
  --header 'content-type: application/json' \
  --data '{"query":"query GetPassTemplates { passTemplates { id name } }"}'

API response:

You will receive create pass in response:

{"data":{"passTemplates":[{"id":"...","name":"..."}]}}

# Production:
https://api.tiketo.eu/graphql

# Provide API TOKEN created in workspace detail
Authorization: TOKEN <YOUR_TOKEN_HERE>