mirror of
https://github.com/luongnv89/claude-howto.git
synced 2026-07-07 11:17:48 +02:00
Evgenij I
8438a0378a
- Translate 07-plugins: devops-automation, documentation, pr-review (READMEs, commands, agents, templates) - Update TRANSLATION_QUEUE.md — all priorities complete (100%) Ref: luongnv89/claude-howto#63
102 lines
2.1 KiB
Markdown
102 lines
2.1 KiB
Markdown
# [METHOD] /api/v1/[endpoint]
|
|
|
|
## Опис
|
|
Короткий опис що робить цей ендпоінт.
|
|
|
|
## Автентифікація
|
|
Необхідний метод автентифікації (напр., Bearer token).
|
|
|
|
## Параметри
|
|
|
|
### Параметри шляху
|
|
| Назва | Тип | Обов'язковий | Опис |
|
|
|-------|-----|-------------|------|
|
|
| id | string | Так | ID ресурсу |
|
|
|
|
### Параметри запиту
|
|
| Назва | Тип | Обов'язковий | Опис |
|
|
|-------|-----|-------------|------|
|
|
| page | integer | Ні | Номер сторінки (за замовч.: 1) |
|
|
| limit | integer | Ні | Елементів на сторінку (за замовч.: 20) |
|
|
|
|
### Тіло запиту
|
|
```json
|
|
{
|
|
"field": "value"
|
|
}
|
|
```
|
|
|
|
## Відповіді
|
|
|
|
### 200 OK
|
|
```json
|
|
{
|
|
"success": true,
|
|
"data": {
|
|
"id": "123",
|
|
"name": "Example"
|
|
}
|
|
}
|
|
```
|
|
|
|
### 400 Bad Request
|
|
```json
|
|
{
|
|
"success": false,
|
|
"error": {
|
|
"code": "VALIDATION_ERROR",
|
|
"message": "Invalid input"
|
|
}
|
|
}
|
|
```
|
|
|
|
### 404 Not Found
|
|
```json
|
|
{
|
|
"success": false,
|
|
"error": {
|
|
"code": "NOT_FOUND",
|
|
"message": "Resource not found"
|
|
}
|
|
}
|
|
```
|
|
|
|
## Приклади
|
|
|
|
### cURL
|
|
```bash
|
|
curl -X GET "https://api.example.com/api/v1/endpoint" \
|
|
-H "Authorization: Bearer YOUR_TOKEN" \
|
|
-H "Content-Type: application/json"
|
|
```
|
|
|
|
### JavaScript
|
|
```javascript
|
|
const response = await fetch('/api/v1/endpoint', {
|
|
headers: {
|
|
'Authorization': 'Bearer token',
|
|
'Content-Type': 'application/json'
|
|
}
|
|
});
|
|
const data = await response.json();
|
|
```
|
|
|
|
### Python
|
|
```python
|
|
import requests
|
|
|
|
response = requests.get(
|
|
'https://api.example.com/api/v1/endpoint',
|
|
headers={'Authorization': 'Bearer token'}
|
|
)
|
|
data = response.json()
|
|
```
|
|
|
|
## Обмеження частоти запитів
|
|
- 1000 запитів на годину для автентифікованих користувачів
|
|
- 100 запитів на годину для публічних ендпоінтів
|
|
|
|
## Пов'язані ендпоінти
|
|
- [GET /api/v1/related](#)
|
|
- [POST /api/v1/related](#)
|