Go

go get github.com/praxicraft-platform/praxicraft-go

export PRAXICRAFT_API_KEY="ct_live_xxxxxxxxxxxxxxxx"

import praxicraft "github.com/praxicraft-platform/praxicraft-go"

client, err := praxicraft.New() // reads PRAXICRAFT_API_KEY
// or praxicraft.New(praxicraft.WithAPIKey("ct_live_…"), praxicraft.WithBaseURL("…"))

package main

import (
    "fmt"
    "log"

    praxicraft "github.com/praxicraft-platform/praxicraft-go"
)

func main() {
    client, err := praxicraft.New()
    if err != nil {
        log.Fatal(err)
    }

    org, err := client.Org.Retrieve()
    if err != nil {
        log.Fatal(err)
    }
    fmt.Println(org.Name, org.Plan, org.InvitesRemaining)

    send := true
    invite, err := client.Invites.Create("senior-backend-screen", praxicraft.InviteCreateParams{
        Email:     "[email protected]",
        Name:      "Jane Doe",
        SendEmail: &send,
    })
    if err != nil {
        log.Fatal(err)
    }
    fmt.Println(invite.InviteToken, invite.InviteURL)

    result, err := client.Results.Retrieve(invite.InviteToken)
    if err != nil {
        log.Fatal(err)
    }
    fmt.Println(result)
}

hook, err := client.Webhooks.Create(
    "https://example.com/hooks/praxicraft",
    []string{"assessment.completed", "candidate.passed"},
    nil,
)
if err != nil {
    log.Fatal(err)
}
// Store hook.SecretKey (whsec_…) — shown once
_, _ = client.Webhooks.Test(hook.ID)
_, _ = client.Webhooks.Update(hook.ID, map[string]any{"is_active": true})

pageSize := 50
err = client.Results.IterAll("senior-backend-screen", &pageSize, nil, func(row praxicraft.ResultRow) error {
    fmt.Println(row.Email, row.Score, row.Passed)
    return nil
})

_, err := client.Invites.Create("demo", praxicraft.InviteCreateParams{Email: "[email protected]"})
var (
    ve    *praxicraft.ValidationError
    scope *praxicraft.InsufficientScopeError
    auth  *praxicraft.AuthenticationError
    rl    *praxicraft.RateLimitError
)
switch {
case errors.As(err, &ve):
    fmt.Println(ve.ErrCode, ve.Details)
case errors.As(err, &scope):
    fmt.Println(scope.ErrCode, scope.RequiredPlan)
case errors.As(err, &auth):
    fmt.Println(auth.ErrCode)
case errors.As(err, &rl):
    fmt.Println(rl.RetryAfter)
default:
    log.Fatal(err)
}