This catalogue of services.

Supported Formats

json

GET /api/services
List all services

Use the id field as parameter for other queries

Supported Formats

json

Errors

401 Unauthorized

Examples

GET /api/v1/services
{
  "page": "1",
  "per_page": "2",
  "token": "valid_token"
}
200
{
  "total": 7,
  "page": 1,
  "per_page": 2,
  "results": [
    {
      "id": "explore-a-abc-earth",
      "name": "Explore A",
      "company": "abc-earth"
    },
    {
      "id": "sense-b-abc-earth",
      "name": "Sense B",
      "company": "abc-earth"
    }
  ]
}
GET /api/v1/services
{
  "token": "invalid_token"
}
401
{
  "error": "unauthorized"
}
GET /api/v1/services
{
  "market": "market-one",
  "token": "valid_token"
}
200
{
  "total": 1,
  "page": 1,
  "per_page": 1,
  "results": [
    {
      "id": "explore-a-abc-earth",
      "name": "Explore A",
      "company": "abc-earth"
    }
  ]
}
GET /api/v1/services
{
  "type": "service-type-a",
  "token": "valid_token"
}
200
{
  "total": 1,
  "page": 1,
  "per_page": 1,
  "results": [
    {
      "id": "explore-b-abc-earth",
      "name": "Explore B",
      "company": "abc-earth"
    }
  ]
}
GET /api/v1/services
{
  "continent": "alpha",
  "token": "valid_token"
}
200
{
  "total": 1,
  "page": 1,
  "per_page": 1,
  "results": [
    {
      "id": "explore-a-abc-earth",
      "name": "Explore A",
      "company": "abc-earth"
    }
  ]
}
GET /api/v1/services
{
  "region": "beta",
  "token": "valid_token"
}
200
{
  "total": 1,
  "page": 1,
  "per_page": 1,
  "results": [
    {
      "id": "explore-a-abc-earth",
      "name": "Explore A",
      "company": "abc-earth"
    }
  ]
}
GET /api/v1/services
{
  "token": "invalid_token"
}
401
{
  "error": "unauthorized"
}

Params

Param name Description
page
optional

page to be returned


Value: Must be String
per_page
optional

number of entries per request


Value: Must be String
market
optional

id of the intended market of services


Value: Must be String
type
optional

id of type of service


Value: Must be String
continent
optional

id of the continent where services are located


Value: Must be String
region
optional

id of the region where services are located


Value: Must be String

GET /api/services/:id
Shows detailed information

This information is also available in the eopages.eu website

Supported Formats

json

Errors

401 Unauthorized

Examples

GET /api/v1/services/explore-a-abc-earth
{
  "token": "valid_token"
}
200
{
  "name": "Explore A",
  "description": "A large text about the service and other info",
  "company": "abc-earth",
  "types": [
    {
      "id": "seeds-counting",
      "name": "Seeds counting"
    },
    {
      "id": "water-temp-calc",
      "name": "Water temp. calc"
    }
  ],
  "markets": [
    {
      "id": "farmers",
      "name": "Farmers"
    },
    {
      "id": "fishers",
      "name": "Fishers"
    }
  ],
  "continents": [
    {
      "id": "europe",
      "name": "Europe"
    },
    {
      "id": "america",
      "name": "America"
    }
  ],
  "regions": [
    {
      "id": "east-europe",
      "name": "East Europe"
    },
    {
      "id": "west-europe",
      "name": "West Europe"
    },
    {
      "id": "south-america",
      "name": "South America"
    },
    {
      "id": "north-america",
      "name": "North America"
    }
  ],
  "photo-gallery": [
    {
      "title": "Photo 01",
      "url": "http://eopagestest.s3.amazonaws.com/assets/21/crop/image_01.jpg"
    },
    {
      "title": "Second Image",
      "url": "http://eopagestest.s3.amazonaws.com/assets/22/crop/foto_02.jpg"
    }
  ]
}
GET /api/v1/services/it-dont-exists
{
  "token": "valid_token"
}
404
{
  "error": "not found"
}
GET /api/v1/services/explore-a-abc-earth
{
  "token": "invalid_token"
}
401
{
  "error": "unauthorized"
}

Params

Param name Description
id
optional

service id, could be obtained from the 'list of services' query or company details


Value: Must be String