SDKs¶
Official SDKs wrap the Kiket APIs with idiomatic helpers, pagination, and retry logic. All SDKs support user tokens, OAuth tokens, and extension API keys.
import { KiketSDK } from '@kiket-dev/sdk';
const sdk = new KiketSDK({
workspaceToken: process.env.KIKET_TOKEN,
});
// Register webhook handler
sdk.on('issue.created', async (payload, ctx) => {
console.log(`New issue: ${payload.issue.title}`);
});
- Promise-based API with TypeScript definitions.
- Built-in helpers for webhook signature verification.
- Quick Start | API Reference
from kiket_sdk import KiketSDK
sdk = KiketSDK(
workspace_token=os.environ['KIKET_TOKEN']
)
@sdk.on('issue.created')
async def handle_issue(payload, ctx):
print(f"New issue: {payload['issue']['title']}")
- Async and sync clients available via
httpxorrequests. - Quick Start | API Reference
import "github.com/kiket-dev/kiket/sdk/go/kiket"
sdk, _ := kiket.New(kiket.Config{
WorkspaceToken: os.Getenv("KIKET_TOKEN"),
})
sdk.On("issue.created", func(ctx context.Context, payload kiket.WebhookPayload, hctx *kiket.HandlerContext) (interface{}, error) {
issue := payload["issue"].(map[string]interface{})
log.Printf("New issue: %s", issue["title"])
return nil, nil
})
- Idiomatic Go with context support.
- Implements
http.Handlerfor easy integration. - Quick Start | API Reference
require 'kiket_sdk'
sdk = KiketSDK.new(workspace_token: ENV['KIKET_TOKEN'])
sdk.on('issue.created') do |payload, ctx|
puts "New issue: #{payload['issue']['title']}"
end
- Integrates with Faraday for middleware customization.
- Includes helpers for popular job frameworks.
- Quick Start | API Reference
import dev.kiket.sdk.KiketSDK;
KiketSDK sdk = new KiketSDK.Builder()
.workspaceToken(System.getenv("KIKET_TOKEN"))
.build();
sdk.on("issue.created", (payload, ctx) -> {
System.out.println("New issue: " + payload.get("issue").get("title"));
});
- Java 11+ with CompletableFuture support.
- Quick Start | API Reference
using Kiket.SDK;
var sdk = new KiketSDK(new KiketConfig {
WorkspaceToken = Environment.GetEnvironmentVariable("KIKET_TOKEN")
});
sdk.On("issue.created", async (payload, ctx) => {
Console.WriteLine($"New issue: {payload["issue"]["title"]}");
});
- .NET 6+ with async/await support.
- Quick Start | API Reference
CLI (kiket)¶
Install via npm:
Common commands:
- kiket login - Authenticate with Kiket
- kiket projects ls - List projects
- kiket issues create - Create an issue
- kiket workflows validate - Validate workflow definitions
See CLI Reference for full documentation.
SDK Features¶
All official SDKs include:
| Feature | Description |
|---|---|
| Webhook Handling | Register handlers for Kiket events |
| Signature Verification | HMAC-SHA256 signature verification |
| Secret Management | Access extension secrets via secure secret storage |
| Custom Data | CRUD operations for custom data modules |
| SLA Events | Query SLA monitoring data |
| Rate Limiting | Check rate limit status |
| Telemetry | Optional usage reporting |
| Manifest Loading | Auto-load settings from extension.yaml |
Installation¶
| Language | Package | Install |
|---|---|---|
| Node.js | @kiket-dev/sdk |
npm install @kiket-dev/sdk |
| Python | kiket-sdk |
pip install kiket-sdk |
| Go | github.com/kiket-dev/kiket/sdk/go |
go get github.com/kiket-dev/kiket/sdk/go |
| Ruby | kiket_sdk |
gem install kiket_sdk |
| Java | dev.kiket:sdk |
Maven/Gradle dependency |
| .NET | Kiket.SDK |
dotnet add package Kiket.SDK |
All SDKs are open source. File issues on GitHub if you discover bugs or want to suggest new helpers.