API Quickstart

https://api-preview.agin.africa/graphql

curl -X POST https://api.agin.cloud/graphql \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "query { account { id name email plan } }"
  }'

{
  "data": {
    "account": {
      "id": "acc_1234567890",
      "name": "Green Valley Farms",
      "email": "admin@greenvalley.com",
      "plan": "PROFESSIONAL"
    }
  }
}

query {
  farms(first: 10) {
    edges {
      node {
        id
        name
        location
        totalArea
      }
    }
  }
}

query GetFarm($farmId: ID!) {
  farm(id: $farmId) {
    id
    name
    location
    fields {
      id
      name
      size
      cropType
    }
  }
}

{
  "farmId": "farm_abc123"
}

query {
  harvests(first: 10, orderBy: { harvestDate: DESC }) {
    id
    cropType
    quantity
    unit
    harvestDate
  }
}

mutation CreateHarvest($input: CreateHarvestInput!) {
  createHarvest(input: $input) {
    harvest {
      id
      cropType
      quantity
      harvestDate
    }
  }
}

{
  "input": {
    "operationId": "op_abc123",
    "cropType": "MAIZE",
    "quantity": 5000,
    "unit": "KG",
    "harvestDate": "2024-10-15"
  }
}

{
  "errors": [
    {
      "message": "The cropType field is required",
      "extensions": {
        "code": "VALIDATION_ERROR"
      }
    }
  ]
}