get a host by name

Changed on
get/hosts/{hostName}

Request

  • Base URL: https://repos.ecosyste.ms/api/v1
  • URL: https://repos.ecosyste.ms/api/v1/hosts/{hostName}
  • Auth: none declared

Path parameters

hostNamestring required

name of host

Query parameters

pageinteger

pagination page number

per_pageinteger

Number of records to return

Response

OK

namestring
urlstring
kindstring
repositories_countinteger
owners_countinteger
icon_urlstring
host_urlstring
repositoris_urlstring
repository_names_urlstring
owners_urlstring
versionstring
created_atstring date-time
updated_atstring date-time
status'online' | 'timeout' | 'connection_failed' | 'http_error' | 'ssl_error' | 'error'

Current status of the host

status_checked_atstring date-time

Timestamp when status was last checked

response_timeinteger nullable

Response time in milliseconds (null if host is offline)

last_errorstring nullable

Last error message encountered

robots_txt_status'success' | 'not_found' | 'error_404' | 'error_500' | 'error_timeout'

Status of robots.txt fetch

robots_txt_updated_atstring date-time nullable

Timestamp when robots.txt was last fetched

robots_txt_urlstring

URL to the host's robots.txt file

onlineboolean

Whether the host is currently online

can_crawl_apiboolean

Whether API crawling is allowed by robots.txt

Changes

  • v1dca49000770bRevision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • v1d423597079ccRevision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status