Skip to content

Endpoints de Environment

Environments representam instalacoes de hospedagem gerenciada (Moodle, WordPress, customizado) vinculadas a entitlements da classe ENV. Cada environment rastreia sua plataforma, tipo e status operacional.

Caminho base: /wp-json/middag-account/v1/environments

Endpoints

MétodoEndpointAuthEscopoDescrição
GET/environmentsJWT + OrgentitlementsListar environments gerenciados
GET/environments/{id}JWT + OrgentitlementsDetalhes do environment
GET/environments/{id}/ticketsJWT + OrgentitlementsSolicitações de serviço vinculadas
POST/environments/{id}/ticketsJWT + OrgentitlementsCriar solicitação de serviço

GET /environments

Listar environments da organização atual.

Headers: X-Middag-Organization: {org_id}

Filtros de query:

ParâmetroTipoValores
statusstringprovisioning, active, maintenance, suspended, decommissioned
platformstringmoodle, wordpress, custom
environment_typestringproduction, staging, development, sandbox

Resposta (200):

json
{
    "success": true,
    "data": [
        {
            "id": 701,
            "name": "Acme Moodle Production",
            "status": "active",
            "platform": "moodle",
            "environment_type": "production",
            "url": "https://lms.example.com",
            "entitlement_id": 102,
            "entitlement_code": "ENV-2026040002",
            "organization_id": 42,
            "created_at": "2026-04-01T10:00:00Z"
        }
    ],
    "meta": {
        "page": 1,
        "per_page": 20,
        "total": 1,
        "pages": 1
    }
}

GET /environments/:id

Detalhes completos do environment.

Campos de resposta: id, name, status, platform, environment_type, url, entitlement_id, entitlement_code, organization_id, metadata, created_at, updated_at.

GET /environments/:id/tickets

Listar solicitações de serviço associadas a este environment.

POST /environments/:id/tickets

Criar uma nova solicitação de serviço para este environment. Clientes so podem criar SRs para entitlements da classe ENV.

Request:

json
{
    "title": "Upgrade Moodle to 4.5",
    "description": "Please upgrade our production instance to version 4.5.",
    "priority": "normal"
}

Resposta (201):

json
{
    "success": true,
    "data": {
        "id": 901,
        "number": "SR-20260001",
        "status": "open",
        "environment_id": 701
    },
    "message": "Service request created"
}

Status de Environment

StatusDescrição
provisioningEm configuração, ainda não disponível
activeTotalmente operacional
maintenanceTemporariamente em manutenção
suspendedAcesso suspenso (ex.: problema de pagamento)
decommissionedDesativado permanentemente (terminal)

Relacionados