APIs conçues selon les principes REST avec HATEOAS, versioning dans l'URL, et hypermedia controls. Utilisation de JSON:API pour la standardisation.
Principes clés :
/**
* @swagger
* /api/v1/domains:
* get:
* summary: Liste des domaines
* parameters:
* - name: page
* in: query
* schema:
* type: integer
* default: 1
* - name: limit
* in: query
* schema:
* type: integer
* default: 20
* responses:
* 200:
* description: Liste des domaines
* content:
* application/json:
* schema:
* type: object
* properties:
* data:
* type: array
* items:
* $ref: '#/components/schemas/Domain'
* links:
* $ref: '#/components/schemas/PaginationLinks'
*/
Design d'APIs RESTful avec principes HATEOAS
Schema GraphQL optimisé avec DataLoader pour éviter le N+1 problem, unions pour les types polymorphes, et subscriptions pour le temps réel.
Avantages de GraphQL :
type Query {
domains(first: Int, after: String): DomainConnection!
domain(id: ID!): Domain
user(id: ID!): User
}
type DomainConnection {
edges: [DomainEdge!]!
pageInfo: PageInfo!
totalCount: Int!
}
type DomainEdge {
node: Domain!
cursor: String!
}
type Domain implements Node {
id: ID!
name: String!
status: DomainStatus!
createdAt: DateTime!
updatedAt: DateTime!
owner: User!
records: [DNSRecord!]!
}
enum DomainStatus {
ACTIVE
PENDING
SUSPENDED
EXPIRED
}
Schema GraphQL optimisé avec DataLoader
