Warrant

接入教程

1. 访问官网注册账号
2. 获取API密钥进行身份验证
3. 在应用中集成Warrant SDK
4. 定义权限规则和用户角色
5. 调用API实现访问控制

使用Warrant API检查用户权限

python

import requests

base_url = 'https://api.warrant.dev'
headers = {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
}

# 检查用户是否有特定权限
def check_permission(user_id, permission):
    endpoint = f'{base_url}/v1/authorize'
    payload = {
        'subject': {'objectType': 'user', 'objectId': user_id},
        'permission': permission
    }
    response = requests.post(endpoint, json=payload, headers=headers)
    return response.status_code == 200

# 示例调用
# result = check_permission('user123', 'read:document')
# print(f'Permission granted: {result}')

通过Warrant API分配用户角色

php

<?php

$baseUrl = 'https://api.warrant.dev';
$apiKey = 'YOUR_API_KEY';

// 为用户分配角色
function assignRoleToUser($userId, $role) {
    $url = $baseUrl . '/v1/warrants';
    $data = [
        'objectType' => 'user',
        'objectId' => $userId,
        'relation' => 'member',
        'subject' => [
            'objectType' => 'role',
            'objectId' => $role
        ]
    ];
    
    $options = [
        'http' => [
            'header' => "Authorization: Bearer $apiKey\r\nContent-Type: application/json",
            'method' => 'POST',
            'content' => json_encode($data)
        ]
    ];
    
    $context = stream_context_create($options);
    $result = file_get_contents($url, false, $context);
    return $result !== false;
}

// 示例调用
// $success = assignRoleToUser('user456', 'editor');
// echo 'Role assigned: ' . ($success ? 'Yes' : 'No');

?>

使用Warrant API验证访问令牌

javascript

const axios = require('axios');

const baseUrl = 'https://api.warrant.dev';
const apiKey = 'YOUR_API_KEY';

// 验证访问令牌并获取权限
async function validateTokenAndGetPermissions(token) {
    const endpoint = `${baseUrl}/v1/session/verify`;
    const headers = {
        'Authorization': `Bearer ${apiKey}`,
        'Content-Type': 'application/json'
    };
    const payload = { token };
    
    try {
        const response = await axios.post(endpoint, payload, { headers });
        return response.data.permissions;
    } catch (error) {
        console.error('Token validation failed:', error.message);
        return [];
    }
}

// 示例调用
// validateTokenAndGetPermissions('some_access_token')
//     .then(permissions => console.log('User permissions:', permissions));

常见问题

如何获取Warrant API的访问密钥？

请访问Warrant官方网站（https://warrant.dev/）注册账户，然后在控制台创建新应用以获取API密钥。确保妥善保管密钥，避免泄露。

Warrant API支持哪些常见的权限模型？

Warrant API支持基于角色的访问控制（RBAC）、基于属性的访问控制（ABAC）和基于关系的访问控制（ReBAC）等多种模型，可根据需求灵活配置。

API请求频率是否有限制？

是的，Warrant API根据您的订阅计划设有速率限制。具体限制可在官方文档中查看，建议在代码中实现适当的重试和错误处理机制。