Endpoint Projects

Base URL

https://api.coders.dev/v1

Listare i progetti

GET /projects

Query parameters:

Parametro Tipo Descrizione
page integer Pagina (default: 1)
per_page integer Risultati per pagina (max: 100)
search string Filtra per nome

Risposta:

{
  "data": [
    {
      "id": "proj_abc123",
      "name": "mio-progetto",
      "framework": "laravel",
      "created_at": "2024-01-15T10:30:00Z",
      "environments": ["production", "staging"]
    }
  ],
  "meta": {
    "total": 12,
    "page": 1,
    "per_page": 20
  }
}

Creare un progetto

POST /projects
{
  "name": "nuovo-progetto",
  "git_repository": "github.com/myorg/repo",
  "framework": "nextjs",
  "region": "eu-west-1"
}

Ottenere un progetto

GET /projects/{id}

Aggiornare un progetto

PATCH /projects/{id}

Eliminare un progetto

DELETE /projects/{id}

Attenzione: L'eliminazione è irreversibile. Tutti i deployment e i dati associati vengono cancellati.

Codici di errore

Codice Significato
400 Richiesta non valida
401 Non autenticato
403 Non autorizzato
404 Progetto non trovato
429 Rate limit superato
500 Errore interno