152 lines
8.3 KiB
PHP
152 lines
8.3 KiB
PHP
|
<?php
|
|||
|
|
require_once 'config.php';
|
|||
|
|
|
|||
|
|
if (!isset($_SESSION['user_id'])) {
|
|||
|
|
header('Location: login.php');
|
|||
|
|
exit;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
try {
|
|||
|
|
$stmt = $pdo->prepare("SELECT api_key FROM users WHERE id = ?");
|
|||
|
|
$stmt->execute([$_SESSION['user_id']]);
|
|||
|
|
$user = $stmt->fetch(PDO::FETCH_ASSOC);
|
|||
|
|
} catch(PDOException $e) {
|
|||
|
|
$user = ['api_key' => null];
|
|||
|
|
}
|
|||
|
|
?>
|
|||
|
|
<!DOCTYPE html>
|
|||
|
|
<html lang="<?php echo $lang; ?>" data-theme="<?php echo $currentUserSettings['dark_mode'] ? 'dark' : 'light'; ?>">
|
|||
|
|
<head>
|
|||
|
|
<meta charset="UTF-8">
|
|||
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|||
|
|
<title><?php echo t('api_docs'); ?> - <?php echo SITE_NAME; ?></title>
|
|||
|
|
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0/css/all.min.css">
|
|||
|
|
<link rel="stylesheet" href="css/style.css">
|
|||
|
|
</head>
|
|||
|
|
<body>
|
|||
|
|
<?php include 'components/navbar.php'; ?>
|
|||
|
|
|
|||
|
|
<div class="container">
|
|||
|
|
<h1><i class="fas fa-code"></i> <?php echo t('api_documentation'); ?></h1>
|
|||
|
|
|
|||
|
|
<div class="api-docs-container">
|
|||
|
|
<section class="api-section card">
|
|||
|
|
<h2><i class="fas fa-key"></i> <?php echo t('api_management'); ?></h2>
|
|||
|
|
<?php if(empty($user['api_key'])): ?>
|
|||
|
|
<p><?php echo t('no_api_key_message'); ?></p>
|
|||
|
|
<form method="POST" action="generate-api-key.php">
|
|||
|
|
<button type="submit" class="btn btn-primary">
|
|||
|
|
<i class="fas fa-plus"></i> <?php echo t('generate_api_key'); ?>
|
|||
|
|
</button>
|
|||
|
|
</form>
|
|||
|
|
<?php else: ?>
|
|||
|
|
<div class="api-key-display">
|
|||
|
|
<label><strong><i class="fas fa-key"></i> <?php echo t('your_api_key'); ?>：</strong></label>
|
|||
|
|
<div class="api-key-input">
|
|||
|
|
<input type="text" value="<?php echo $user['api_key']; ?>" id="apiKey" readonly>
|
|||
|
|
<button onclick="copyApiKey()" class="btn">
|
|||
|
|
<i class="fas fa-copy"></i> <?php echo t('copy'); ?>
|
|||
|
|
</button>
|
|||
|
|
<form method="POST" action="generate-api-key.php" style="display: inline;">
|
|||
|
|
<button type="submit" class="btn btn-secondary" onclick="return confirm('<?php echo t('confirm_regenerate_api_key'); ?>')">
|
|||
|
|
<i class="fas fa-sync"></i> <?php echo t('regenerate_key'); ?>
|
|||
|
|
</button>
|
|||
|
|
</form>
|
|||
|
|
</div>
|
|||
|
|
<small><i class="fas fa-shield-alt"></i> <?php echo t('keep_secret'); ?></small>
|
|||
|
|
</div>
|
|||
|
|
<?php endif; ?>
|
|||
|
|
</section>
|
|||
|
|
|
|||
|
|
<section class="api-section card mt-3">
|
|||
|
|
<h2><i class="fas fa-plug"></i> <?php echo t('api_endpoints'); ?></h2>
|
|||
|
|
|
|||
|
|
<div class="api-endpoint">
|
|||
|
|
<h3><i class="fas fa-cloud-upload-alt"></i> 1. <?php echo t('upload_image'); ?></h3>
|
|||
|
|
<div class="code-block">
|
|||
|
|
<span class="endpoint">POST</span> <?php echo SITE_URL; ?>/api/upload.php<br><br>
|
|||
|
|
<span class="comment">// <?php echo t('headers'); ?>：</span><br>
|
|||
|
|
Content-Type: multipart/form-data<br><br>
|
|||
|
|
<span class="comment">// <?php echo t('parameters'); ?>：</span><br>
|
|||
|
|
api_key = <span class="param">string</span> (<?php echo t('required'); ?>)<br>
|
|||
|
|
image = <span class="param">file</span> (<?php echo t('required'); ?>)<br>
|
|||
|
|
title = <span class="param">string</span> (<?php echo t('optional'); ?>)<br>
|
|||
|
|
tags = <span class="param">string</span> (<?php echo t('optional'); ?>)<br>
|
|||
|
|
is_public = <span class="param">integer</span> (<?php echo t('optional'); ?>)<br><br>
|
|||
|
|
<span class="comment">// <?php echo t('success_response'); ?>：</span><br>
|
|||
|
|
{<br>
|
|||
|
|
"success": true,<br>
|
|||
|
|
"data": {<br>
|
|||
|
|
"id": 123,<br>
|
|||
|
|
"title": "<?php echo t('image_title'); ?>",<br>
|
|||
|
|
"url": "<?php echo SITE_URL; ?>/view-image.php?id=123",<br>
|
|||
|
|
"direct_url": "<?php echo SITE_URL; ?>/uploads/filename.jpg",<br>
|
|||
|
|
"tags": ["<?php echo t('landscape'); ?>", "<?php echo t('nature'); ?>"]<br>
|
|||
|
|
}<br>
|
|||
|
|
}
|
|||
|
|
</div>
|
|||
|
|
</div>
|
|||
|
|
|
|||
|
|
<div class="api-endpoint mt-3">
|
|||
|
|
<h3><i class="fas fa-images"></i> 2. <?php echo t('get_images'); ?></h3>
|
|||
|
|
<div class="code-block">
|
|||
|
|
<span class="endpoint">GET</span> <?php echo SITE_URL; ?>/api/images.php?api_key=<?php echo $user['api_key'] ?? 'YOUR_API_KEY'; ?>&page=1&limit=20<br><br>
|
|||
|
|
<span class="comment">// <?php echo t('parameters'); ?>：</span><br>
|
|||
|
|
api_key = <span class="param">string</span> (<?php echo t('required'); ?>)<br>
|
|||
|
|
page = <span class="param">integer</span> (<?php echo t('optional'); ?>)<br>
|
|||
|
|
limit = <span class="param">integer</span> (<?php echo t('optional'); ?>)<br><br>
|
|||
|
|
<span class="comment">// <?php echo t('success_response'); ?>：</span><br>
|
|||
|
|
{<br>
|
|||
|
|
"success": true,<br>
|
|||
|
|
"data": [<br>
|
|||
|
|
{<br>
|
|||
|
|
"id": 123,<br>
|
|||
|
|
"title": "<?php echo t('image_title'); ?>",<br>
|
|||
|
|
"url": "<?php echo SITE_URL; ?>/view-image.php?id=123",<br>
|
|||
|
|
"direct_url": "<?php echo SITE_URL; ?>/uploads/filename.jpg",<br>
|
|||
|
|
"is_public": 1,<br>
|
|||
|
|
"views": 45,<br>
|
|||
|
|
"file_size_formatted": "2.5 MB"<br>
|
|||
|
|
}<br>
|
|||
|
|
],<br>
|
|||
|
|
"pagination": {<br>
|
|||
|
|
"page": 1,<br>
|
|||
|
|
"limit": 20,<br>
|
|||
|
|
"total": 150,<br>
|
|||
|
|
"pages": 8<br>
|
|||
|
|
}<br>
|
|||
|
|
}
|
|||
|
|
</div>
|
|||
|
|
</div>
|
|||
|
|
|
|||
|
|
<div class="api-endpoint mt-3">
|
|||
|
|
<h3><i class="fas fa-terminal"></i> 3. <?php echo t('curl_examples'); ?></h3>
|
|||
|
|
<div class="code-block">
|
|||
|
|
<span class="comment"># <?php echo t('upload_image'); ?></span><br>
|
|||
|
|
curl -X POST \<br>
|
|||
|
|
-F "api_key=<?php echo $user['api_key'] ?? 'YOUR_API_KEY'; ?>" \<br>
|
|||
|
|
-F "title=<?php echo t('my_image'); ?>" \<br>
|
|||
|
|
-F "is_public=1" \<br>
|
|||
|
|
-F "image=@/path/to/your/image.jpg" \<br>
|
|||
|
|
"<?php echo SITE_URL; ?>/api/upload.php"
|
|||
|
|
</div>
|
|||
|
|
|
|||
|
|
<div class="code-block mt-2">
|
|||
|
|
<span class="comment"># <?php echo t('get_images'); ?></span><br>
|
|||
|
|
curl "<?php echo SITE_URL; ?>/api/images.php?api_key=<?php echo $user['api_key'] ?? 'YOUR_API_KEY'; ?>&page=1&limit=10"
|
|||
|
|
</div>
|
|||
|
|
</div>
|
|||
|
|
</section>
|
|||
|
|
</div>
|
|||
|
|
</div>
|
|||
|
|
|
|||
|
|
<script>
|
|||
|
|
function copyApiKey() {
|
|||
|
|
const apiKey = document.getElementById('apiKey');
|
|||
|
|
apiKey.select();
|
|||
|
|
document.execCommand('copy');
|
|||
|
|
alert('<?php echo t('api_key_copied'); ?>');
|
|||
|
|
}
|
|||
|
|
</script>
|
|||
|
|
</body>
|
|||
|
|
</html>
|