Authentication

1
import requests
2
3
TOKEN_URL = "https://api.further.ai/api/v1/oauth2/access_token"
4
5
def get_access_token(client_id: str, client_secret: str) -> str:
6
    """Exchange client credentials for an access token."""
7
    response = requests.post(TOKEN_URL, json={
8
        "client_id": client_id,
9
        "client_secret": client_secret
10
    })
11
    response.raise_for_status()
12
    return response.json()["access_token"]
13
14
15
# Usage
16
access_token = get_access_token("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET")

1
import time
2
import requests
3
4
TOKEN_URL = "https://api.further.ai/api/v1/oauth2/access_token"
5
6
class FurtherAIAuth:
7
    """Manages Further AI API authentication with automatic token refresh."""
8
9
    def __init__(self, client_id: str, client_secret: str):
10
        self.client_id = client_id
11
        self.client_secret = client_secret
12
        self._token = None
13
        self._expires_at = 0
14
15
    def get_token(self) -> str:
16
        """Return a valid access token, refreshing if needed."""
17
        # Refresh 5 minutes before expiry
18
        if self._token is None or time.time() > (self._expires_at - 300):
19
            self._refresh()
20
        return self._token
21
22
    def _refresh(self):
23
        response = requests.post(TOKEN_URL, json={
24
            "client_id": self.client_id,
25
            "client_secret": self.client_secret
26
        })
27
        response.raise_for_status()
28
        data = response.json()
29
        self._token = data["access_token"]
30
        self._expires_at = time.time() + data.get("expires_in", 3600)
31
32
    def get_headers(self) -> dict:
33
        """Return Authorization headers ready for requests."""
34
        return {"Authorization": f"Bearer {self.get_token()}"}
35
36
37
# Usage
38
auth = FurtherAIAuth("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET")
39
40
# Headers are always fresh
41
response = requests.get(
42
    "https://api.further.ai/api/v1/workflow-builder/workflows/WF_ID/executions/EX_ID",
43
    headers=auth.get_headers()
44
)