القائمة
Guide complet des API REST : principes RESTful, design endpoints, versioning, pagination, HATEOAS, sécurité, documentation OpenAPI, testing.
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
استنادا إلى تصنيف SOC المهني
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/JohnNuwan/EVA_CORE --skill api-restيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
عرض SKILL.md
Concevoir et maintenir un watchdog auto-correcteur pour services HTTP — checks de santé, auto-restart, état persistant, rapports et pièges bash.
Serveur de messagerie sécurisé auto-hébergé (Signal-like) avec Flask + WebSocket + AES-256-GCM + pont EVA
ADAM-SENTINEL — Veilleur technologique 24h/24h. Scanne 10 domaines, cree des rapports, met a jour les skills, alerte sur les CVE et breaking changes.
| name | api-rest |
| description | Guide complet des API REST : principes RESTful, design endpoints, versioning, pagination, HATEOAS, sécurité, documentation OpenAPI, testing. |
| tags | ["rest","api","http","openapi","swagger","endpoints","versioning","pagination","hateoas","sécurité","testing"] |
GET /users → Liste
POST /users → Créer
GET /users/{id} → Un élément
PUT /users/{id} → Remplacer
PATCH /users/{id} → Modifier partiellement
DELETE /users/{id} → Supprimer
GET /users/{id}/orders → Relation
/users pas /user/order-items/getUsers/v1/users ou header Accept: application/vnd.api.v1+json| Code | Usage |
|---|---|
| 200 OK | GET, PUT, PATCH réussis |
| 201 Created | POST (inclure Location header) |
| 204 No Content | DELETE réussi |
| 400 Bad Request | Validation échouée |
| 401 Unauthorized | Auth manquante |
| 403 Forbidden | Pas autorisé |
| 404 Not Found | Ressource inexistante |
| 409 Conflict | Conflit (doublon) |
| 422 Unprocessable | Validation métier |
| 429 Too Many | Rate limiting |
| 500 Server Error | Erreur générique |
{
"data": { "id": "42", "type": "users", "attributes": { "name": "Alice" } },
"meta": { "requestId": "req-abc-123" }
}
{
"error": {
"code": "VALIDATION_ERROR",
"message": "Le champ email est invalide",
"details": [{ "field": "email", "rule": "format", "value": "invalid" }]
}
}
GET /users?cursor=eyJpZCI6NDJ9&limit=20
→ { "data": [...], "meta": { "nextCursor": "eyJpZCI6NzN9", "hasMore": true } }
GET /users?page=2&per_page=20
→ { "data": [...], "meta": { "page": 2, "perPage": 20, "total": 150 } }
{
"data": { "id": "42", "name": "Alice" },
"links": {
"self": "/users/42",
"orders": "/users/42/orders",
"update": { "href": "/users/42", "method": "PATCH" }
}
}
Authorization: Bearer <jwt>X-API-Key: <key>X-RateLimit-*Access-Control-Allow-Originopenapi: 3.1.0
info:
title: Users API
version: 1.0.0
paths:
/users:
get:
summary: Liste des utilisateurs
responses:
'200':
description: Succès
content:
application/json:
schema:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/User'
| Langage | Framework |
|---|---|
| Node.js | Express, Fastify, Hono, NestJS |
| Python | FastAPI, Django REST Framework |
| Go | Gin, Echo, Chi |
| Rust | Axum, Actix-web |
| Java | Spring Boot, Quarkus |
| .NET | ASP.NET Core Minimal API |