For developers

Tekomata API

Read a photo or PDF into data with the AI model of your choice, in a standard form, with the page and the place on the document where each value was read; write blog posts with AI, and hear when each is done by webhook. Read the balance and top it up by bank transfer. Paid from the shop's Tekomata credit — try it below with your integration's access token.

1. Getting access

Once at the start, then every 15 minutes.

  1. 1
    The shop

    The shop owner opens Pengaturan → Integrasi API (Settings → API integrations), creates an integration, ticks the permissions it needs, then gives you the client ID and client secret. The secret is shown only once. Integrations can be created on the Gold plan and above.

  2. 2
    Your systemPOST /v1/token

    Send the client ID and secret as HTTP Basic. The response is an access token (tka_…) valid for 15 minutes.

  3. 3
    Your systemGET /v1/whoami

    Send the token as "Authorization: Bearer tka_…" on every call. Whoami shows the integration's name, permissions, and request limit; useful for checking your setup.

  4. 4
    Your system

    When the token expires, the API answers 401 access_token_expired. Request a new token with the same client ID and secret; there is no refresh token.

  • The client ID and secret are accepted only at /v1/token. Store the secret like a password.
  • Rotate the secret without downtime: create a new secret on the integration page, deploy it, then revoke the old one. A revoked secret is refused at once, including tokens already issued.