Errors & Retries

asset, err := client.Upload(ctx, opts)
switch {
case err == nil:
    return asset.URL, nil
case dreep.IsPaymentRequired(err):
    // 402 — a plan limit was reached
case dreep.IsNotFound(err):
    // 404 — unknown asset, folder, preset or upload
case dreep.IsInvalidRequest(err):
    // the API rejected the request as malformed
default:
    return "", err
}

type Error struct {
    StatusCode int    // HTTP status returned by the API
    Code       string // machine-readable code, e.g. "invalid_request", when provided
    Message    string // human-readable message

    // Populated only on 402 billing-limit errors that carry the detail
    FeatureKey string
    Used       flexInt64 // read with .Int64()
    Limit      flexInt64 // read with .Int64()
}

var e *dreep.Error
if errors.As(err, &e) {
    log.Printf("dreep %d %s: %s", e.StatusCode, e.Code, e.Message)
}

if key, ok := dreep.FeatureLimit(err); ok {
    var e *dreep.Error
    errors.As(err, &e)
    log.Printf("limit hit on %s: used %d of %d", key, e.Used.Int64(), e.Limit.Int64())
}

client, err := dreep.New(key,
    dreep.WithMaxRetries(4),                        // 0 disables retries
    dreep.WithRetryBaseDelay(200*time.Millisecond),
)

ctx, cancel := context.WithTimeout(context.Background(), 2*time.Minute)
defer cancel()

asset, err := client.Upload(ctx, opts)
if errors.Is(err, context.DeadlineExceeded) {
    // the upload took longer than two minutes
}