38 lines
940 B
Markdown
38 lines
940 B
Markdown
# Jira Vein
|
|
|
|
Jira connector for Pawprint Artery.
|
|
|
|
## Authentication
|
|
|
|
Two ways to provide Jira credentials:
|
|
|
|
### 1. Web UI (Headers)
|
|
Enter credentials in the web form at https://artery.mcrn.ar
|
|
- Credentials sent as `X-Jira-Email` and `X-Jira-Token` headers
|
|
- Use for demos, testing, or when credentials change frequently
|
|
|
|
### 2. Local .env file (Fallback)
|
|
Create `.env` (not committed to git):
|
|
```bash
|
|
cp .env.example .env
|
|
# Edit .env with your credentials
|
|
```
|
|
|
|
The system tries headers first, then falls back to `.env`.
|
|
|
|
## Getting a Jira API Token
|
|
|
|
1. Go to https://id.atlassian.com/manage-profile/security/api-tokens
|
|
2. Click "Create API token"
|
|
3. Copy the token (starts with `ATATT3x`)
|
|
4. Use in UI or add to `.env`
|
|
|
|
## Endpoints
|
|
|
|
- `GET /jira/health` - Connection test
|
|
- `GET /jira/mine` - My assigned tickets
|
|
- `GET /jira/ticket/{key}` - Ticket details
|
|
- `POST /jira/search` - Raw JQL search
|
|
|
|
Add `?text=true` for LLM-friendly output.
|