Japan National Exam Schedules
Japanese national exam and result dates as published by MHLW, with tracked date changes.
¿Debería usar esto?
Calidad y seguridad
A
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
~6,223Tokens (definiciones de herramientas)
~19.1 KBTamaño de respuesta típico
Impacto significativo en la atención (4.86% del contexto de 128k)
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"jp-exam-schedules": {
"url": "https://jp-exam-schedules-production.mk-career-planning.workers.dev/mcp"
}
}
}Puntos de conexión remotos
https://jp-exam-schedules-production.mk-career-planning.workers.dev/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (4)
🟢 Solo lectura🟡 Escritura🔴 Eliminación⚪ Desconocido
🟢catalog
List the tools of this server with prices, data sources, licensing, daily limits and data freshness.
Esquema de entrada
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}Esquema de salida
{
"type": "object",
"properties": {
"server": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"version": {
"type": "string"
},
"stage": {
"type": "string"
}
},
"required": [
"name",
"version",
"stage"
],
"additionalProperties": {}
},
"payment": {
"type": "object",
"properties": {
"protocol": {
"type": "string"
},
"network": {
"type": "string"
},
"asset": {
"type": "string"
},
"enabled": {
"type": "boolean"
}
},
"required": [
"protocol",
"network",
"asset",
"enabled"
],
"additionalProperties": {}
},
"daily_limits": {
"type": "object",
"properties": {},
"additionalProperties": {},
"description": "Daily limits of paid calls (calls, usd, timezone) or a misconfiguration notice."
},
"paused": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "boolean"
},
"description": "Operator pause flags (true = paused)."
},
"tools": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"price_usd": {
"type": "number",
"description": "Price per call in USD (0 = free)."
},
"description": {
"type": "string"
}
},
"required": [
"name",
"price_usd",
"description"
],
"additionalProperties": {}
},
"description": "Every tool of this server with its price."
},
"legal": {
"type": "object",
"properties": {},
"additionalProperties": {}
},
"fetch_status_values": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
"provenance": {
"type": "array",
"items": {
"type": "object",
"properties": {
"source": {
"type": "object",
"properties": {
"publisher": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"publisher",
"url"
],
"additionalProperties": {},
"description": "Publisher and URL of the upstream document or dataset."
},
"upstream_updated_at": {
"description": "Update time stated by the upstream, or null when it states none.",
"type": [
"string",
"null"
]
},
"retrieved_at": {
"description": "When this service retrieved the upstream data (null if unknown).",
"type": [
"string",
"null"
]
},
"content_sha256": {
"type": [
"string",
"null"
]
},
"parser_version": {
"type": "string"
},
"fetch_status": {
"type": "string",
"enum": [
"found",
"empty",
"stale",
"unavailable",
"unsupported"
],
"description": "found / empty / stale / unavailable / unsupported (see catalog fetch_status_values)."
},
"processed_by": {
"type": "string"
}
},
"required": [
"source",
"upstream_updated_at",
"retrieved_at",
"content_sha256",
"parser_version",
"fetch_status",
"processed_by"
],
"additionalProperties": {},
"description": "Freshness receipt for one upstream source."
},
"description": "Freshness receipts for every upstream source used."
},
"terms": {
"type": "string",
"description": "URL of the terms of service."
}
},
"required": [
"server",
"payment",
"daily_limits",
"paused",
"tools",
"legal",
"terms"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {}
}🟢exam_schedule_lookup(exam, category, include_undated, limit)
When is this Japanese national exam held and when are results announced, as published on MHLW's list page, and did the dates change? Give exam (exam_id like nurse, or the name in Japanese or English); omit it to list exams, optionally by category. Returns next_events and all events with ISO dates, revision_status, revisions (before and after), possibly_stale, retrieved_at and source. Application periods are not covered. Confirm on the official exam page.
Esquema de entrada
{
"type": "object",
"properties": {
"exam": {
"description": "exam_id (e.g. nurse, pharmacist, certified-social-worker) or exam name in Japanese (看護師国家試験, 看護師) or English",
"type": "string",
"maxLength": 100
},
"category": {
"description": "Optional filter when listing: medical (Medical, pharmaceutical, health and food sanitation), occupational_safety (Technical, occupational safety and health), beauty_health (Beauty and health), welfare_care (Welfare and long-term care)",
"type": "string",
"enum": [
"medical",
"occupational_safety",
"beauty_health",
"welfare_care"
]
},
"include_undated": {
"description": "When listing, also include exams for which the page gives no dates (default false)",
"anyOf": [
{
"type": "boolean"
},
{
"type": "string",
"enum": [
"true",
"false"
]
}
]
},
"limit": {
"description": "Maximum number of exams when listing, 1-120 (default 50)",
"type": "integer",
"minimum": 1,
"maximum": 120
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}Esquema de salida
{
"type": "object",
"properties": {
"official_check": {
"type": "object",
"properties": {
"message": {
"type": "string"
},
"message_ja": {
"type": "string"
},
"urls": {
"type": "array",
"items": {
"type": "string"
}
},
"schedule_change_notices_url": {
"type": "string"
}
},
"required": [
"message",
"message_ja",
"urls",
"schedule_change_notices_url"
],
"additionalProperties": {},
"description": "Read first: dates as published on MHLW's list page at retrieved_at; confirm on the official exam page before applying."
},
"query": {
"type": "object",
"properties": {
"exam": {
"type": [
"string",
"null"
]
}
},
"required": [
"exam"
],
"additionalProperties": {}
},
"status": {
"type": "string",
"enum": [
"listed",
"not_found_in_checked_records",
"no_longer_listed_since",
"expired",
"unknown"
],
"description": "listed = on the current list page; no_longer_listed_since = seen earlier by this service, not on the current page (reason not stated); not_found_in_checked_records = not on the page nor seen leaving it since tracking_since; unknown = page not loaded or stale, or only partial-name candidates (unknown_reason)."
},
"unknown_reason": {
"type": [
"string",
"null"
]
},
"status_note": {
"type": "string"
},
"registry_status": {
"anyOf": [
{
"type": "object",
"properties": {
"registry": {
"type": "string"
},
"registry_name_en": {
"type": "string"
},
"registry_name_ja": {
"type": "string"
},
"authority": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"listed",
"not_found_in_checked_records",
"no_longer_listed_since",
"expired",
"unknown"
],
"description": "listed: A record matching the query by identifier or exact name is in the version of the official record checked (status_as_of). not_found_in_checked_records: No matching record in the version checked. It says nothing about other registries, other names or periods before tracking_since. no_longer_listed_since: A matching record was seen by this service earlier and is not in the current version since the date given. The reason is not published here and is not inferred. expired: The official record itself states an end or expiry date that has passed. The reason is not inferred. unknown: Could not be determined: not checked, data unavailable or stale, or only similar-name candidates were found (see unknown_reason)."
},
"unknown_reason": {
"type": [
"string",
"null"
]
},
"status_since": {
"type": [
"string",
"null"
]
},
"status_as_of": {
"type": [
"string",
"null"
]
},
"last_observed_at": {
"type": [
"string",
"null"
]
},
"tracking_since": {
"type": [
"string",
"null"
]
},
"source_url": {
"type": "string"
},
"matched_records": {
"type": "array",
"items": {
"type": "object",
"properties": {},
"additionalProperties": {}
}
},
"match_basis": {
"type": "string",
"enum": [
"exact_id",
"exact_name",
"fuzzy_candidate",
"none"
]
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"registry",
"registry_name_en",
"registry_name_ja",
"authority",
"status",
"unknown_reason",
"status_since",
"status_as_of",
"last_observed_at",
"tracking_since",
"source_url",
"matched_records",
"match_basis",
"limitations"
],
"additionalProperties": {}
},
{
"type": "null"
}
],
"description": "The common registry status section shared across this operator's servers. Null when listing without an exam query."
},
"today_jst": {
"type": "string"
},
"exams": {
"type": "array",
"items": {
"type": "object",
"properties": {
"exam_id": {
"type": "string"
},
"exam_name_ja": {
"type": "string"
},
"exam_name_en": {
"type": [
"string",
"null"
]
},
"listing_type": {
"type": "string",
"enum": [
"exam",
"course"
]
},
"category": {
"type": "string"
},
"exam_page_url": {
"type": [
"string",
"null"
]
},
"listed": {
"type": "boolean"
},
"no_longer_listed_since": {
"type": [
"string",
"null"
]
},
"listing_kind": {
"type": "string",
"enum": [
"dated",
"dates_not_on_list"
]
},
"dates_not_on_list_text": {
"type": [
"string",
"null"
]
},
"published_as_of": {
"type": [
"string",
"null"
]
},
"coverage_status": {
"type": "string",
"enum": [
"complete",
"partial",
"unknown"
]
},
"possibly_stale": {
"type": "boolean"
},
"possibly_stale_reason": {
"type": [
"string",
"null"
]
},
"next_events": {
"type": "array",
"items": {
"type": "object",
"properties": {
"event_id": {
"type": "string",
"description": "Stable id: exam_id:fiscal_year:event_type:part:sitting."
},
"exam_id": {
"type": "string"
},
"exam_name_ja": {
"type": [
"string",
"null"
]
},
"exam_name_en": {
"type": [
"string",
"null"
]
},
"session": {
"description": "Session number (dai N kai) as published; null because the list page does not show it.",
"type": [
"string",
"null"
]
},
"event_type": {
"type": "string",
"enum": [
"exam",
"result_announcement",
"application"
]
},
"part": {
"type": "string"
},
"part_ja": {
"type": [
"string",
"null"
]
},
"sitting": {
"type": "number"
},
"start_date": {
"description": "YYYY-MM-DD in Asia/Tokyo; null when the page gives no day (see approximate_period).",
"type": [
"string",
"null"
]
},
"end_date": {
"description": "YYYY-MM-DD; same as start_date for a single day.",
"type": [
"string",
"null"
]
},
"days": {
"type": "array",
"items": {
"type": "string"
}
},
"alternative_days": {
"type": "boolean",
"description": "true when the page says one day OR another (for example 5 or 6 November); which day applies is not on the list page."
},
"date_precision": {
"type": "string",
"enum": [
"day",
"part_of_month"
]
},
"date_text_as_published": {
"type": "string"
},
"timezone": {
"type": "string",
"const": "Asia/Tokyo"
},
"deadline_basis": {
"anyOf": [
{
"type": "string",
"enum": [
"received_by",
"postmarked_by",
"online_closes",
"unknown"
]
},
{
"type": "null"
}
],
"description": "Application events only: how the deadline is counted when the page states it; unknown otherwise (never inferred). null for other events."
},
"source_url": {
"type": "string"
},
"exam_page_url": {
"type": [
"string",
"null"
]
},
"published_as_of": {
"type": [
"string",
"null"
]
},
"retrieved_at": {
"type": [
"string",
"null"
]
},
"first_seen_at": {
"type": "string"
},
"last_changed_at": {
"type": [
"string",
"null"
]
},
"revision_status": {
"type": "string",
"enum": [
"initial",
"changed",
"removed_from_list"
]
},
"coverage_status": {
"type": "string",
"enum": [
"complete",
"partial",
"unknown"
]
},
"is_past": {
"type": [
"boolean",
"null"
]
},
"revisions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"observed_at": {
"type": "string"
},
"before": {
"type": "object",
"properties": {
"date_precision": {
"type": "string",
"enum": [
"day",
"part_of_month"
]
},
"start_date": {
"type": [
"string",
"null"
]
},
"end_date": {
"type": [
"string",
"null"
]
},
"days": {
"type": "array",
"items": {
"type": "string"
}
},
"alternative_days": {
"type": "boolean"
},
"date_text_as_published": {
"type": "string"
}
},
"required": [
"date_precision",
"start_date",
"end_date",
"days",
"alternative_days",
"date_text_as_published"
],
"additionalProperties": {}
},
"after": {
"type": "object",
"properties": {
"date_precision": {
"type": "string",
"enum": [
"day",
"part_of_month"
]
},
"start_date": {
"type": [
"string",
"null"
]
},
"end_date": {
"type": [
"string",
"null"
]
},
"days": {
"type": "array",
"items": {
"type": "string"
}
},
"alternative_days": {
"type": "boolean"
},
"date_text_as_published": {
"type": "string"
}
},
"required": [
"date_precision",
"start_date",
"end_date",
"days",
"alternative_days",
"date_text_as_published"
],
"additionalProperties": {}
}
},
"required": [
"observed_at",
"before",
"after"
],
"additionalProperties": {}
},
"description": "Date changes observed by this service (before and after), within the free history window."
}
},
"required": [
"event_id",
"exam_id",
"exam_name_ja",
"exam_name_en",
"session",
"event_type",
"part",
"part_ja",
"sitting",
"start_date",
"end_date",
"days",
"alternative_days",
"date_precision",
"date_text_as_published",
"timezone",
"deadline_basis",
"source_url",
"exam_page_url",
"published_as_of",
"retrieved_at",
"first_seen_at",
"last_changed_at",
"revision_status",
"coverage_status",
"is_past",
"revisions"
],
"additionalProperties": {}
}
},
"events": {
"type": "array",
"items": {
"type": "object",
"properties": {
"event_id": {
"type": "string",
"description": "Stable id: exam_id:fiscal_year:event_type:part:sitting."
},
"exam_id": {
"type": "string"
},
"exam_name_ja": {
"type": [
"string",
"null"
]
},
"exam_name_en": {
"type": [
"string",
"null"
]
},
"session": {
"description": "Session number (dai N kai) as published; null because the list page does not show it.",
"type": [
"string",
"null"
]
},
"event_type": {
"type": "string",
"enum": [
"exam",
"result_announcement",
"application"
]
},
"part": {
"type": "string"
},
"part_ja": {
"type": [
"string",
"null"
]
},
"sitting": {
"type": "number"
},
"start_date": {
"description": "YYYY-MM-DD in Asia/Tokyo; null when the page gives no day (see approximate_period).",
"type": [
"string",
"null"
]
},
"end_date": {
"description": "YYYY-MM-DD; same as start_date for a single day.",
"type": [
"string",
"null"
]
},
"days": {
"type": "array",
"items": {
"type": "string"
}
},
"alternative_days": {
"type": "boolean",
"description": "true when the page says one day OR another (for example 5 or 6 November); which day applies is not on the list page."
},
"date_precision": {
"type": "string",
"enum": [
"day",
"part_of_month"
]
},
"date_text_as_published": {
"type": "string"
},
"timezone": {
"type": "string",
"const": "Asia/Tokyo"
},
"deadline_basis": {
"anyOf": [
{
"type": "string",
"enum": [
"received_by",
"postmarked_by",
"online_closes",
"unknown"
]
},
{
"type": "null"
}
],
"description": "Application events only: how the deadline is counted when the page states it; unknown otherwise (never inferred). null for other events."
},
"source_url": {
"type": "string"
},
"exam_page_url": {
"type": [
"string",
"null"
]
},
"published_as_of": {
"type": [
"string",
"null"
]
},
"retrieved_at": {
"type": [
"string",
"null"
]
},
"first_seen_at": {
"type": "string"
},
"last_changed_at": {
"type": [
"string",
"null"
]
},
"revision_status": {
"type": "string",
"enum": [
"initial",
"changed",
"removed_from_list"
]
},
"coverage_status": {
"type": "string",
"enum": [
"complete",
"partial",
"unknown"
]
},
"is_past": {
"type": [
"boolean",
"null"
]
},
"revisions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"observed_at": {
"type": "string"
},
"before": {
"type": "object",
"properties": {
"date_precision": {
"type": "string",
"enum": [
"day",
"part_of_month"
]
},
"start_date": {
"type": [
"string",
"null"
]
},
"end_date": {
"type": [
"string",
"null"
]
},
"days": {
"type": "array",
"items": {
"type": "string"
}
},
"alternative_days": {
"type": "boolean"
},
"date_text_as_published": {
"type": "string"
}
},
"required": [
"date_precision",
"start_date",
"end_date",
"days",
"alternative_days",
"date_text_as_published"
],
"additionalProperties": {}
},
"after": {
"type": "object",
"properties": {
"date_precision": {
"type": "string",
"enum": [
"day",
"part_of_month"
]
},
"start_date": {
"type": [
"string",
"null"
]
},
"end_date": {
"type": [
"string",
"null"
]
},
"days": {
"type": "array",
"items": {
"type": "string"
}
},
"alternative_days": {
"type": "boolean"
},
"date_text_as_published": {
"type": "string"
}
},
"required": [
"date_precision",
"start_date",
"end_date",
"days",
"alternative_days",
"date_text_as_published"
],
"additionalProperties": {}
}
},
"required": [
"observed_at",
"before",
"after"
],
"additionalProperties": {}
},
"description": "Date changes observed by this service (before and after), within the free history window."
}
},
"required": [
"event_id",
"exam_id",
"exam_name_ja",
"exam_name_en",
"session",
"event_type",
"part",
"part_ja",
"sitting",
"start_date",
"end_date",
"days",
"alternative_days",
"date_precision",
"date_text_as_published",
"timezone",
"deadline_basis",
"source_url",
"exam_page_url",
"published_as_of",
"retrieved_at",
"first_seen_at",
"last_changed_at",
"revision_status",
"coverage_status",
"is_past",
"revisions"
],
"additionalProperties": {}
}
},
"application_periods": {
"type": "object",
"properties": {
"covered": {
"type": "boolean"
},
"note": {
"type": "string"
},
"see": {
"type": "string"
}
},
"required": [
"covered",
"note",
"see"
],
"additionalProperties": {}
},
"recent_history": {
"type": "array",
"items": {
"type": "object",
"properties": {},
"additionalProperties": {}
}
},
"first_seen_at": {
"type": "string"
},
"last_changed_at": {
"type": [
"string",
"null"
]
}
},
"required": [
"exam_id",
"exam_name_ja",
"exam_name_en",
"listing_type",
"category",
"exam_page_url",
"listed",
"no_longer_listed_since",
"listing_kind",
"dates_not_on_list_text",
"published_as_of",
"coverage_status",
"possibly_stale",
"possibly_stale_reason",
"next_events",
"events",
"application_periods",
"recent_history",
"first_seen_at",
"last_changed_at"
],
"additionalProperties": {}
}
},
"candidates": {
"type": "array",
"items": {
"type": "object",
"properties": {
"exam_id": {
"type": "string"
},
"exam_name_ja": {
"type": "string"
}
},
"required": [
"exam_id",
"exam_name_ja"
],
"additionalProperties": {}
},
"description": "Partial-name candidates when no exam has exactly this name or id. Not matches."
},
"total": {
"type": "number"
},
"truncated": {
"type": "boolean"
},
"source": {
"type": "object",
"properties": {
"list_page_url": {
"type": "string"
},
"published_as_of": {
"type": [
"string",
"null"
]
},
"retrieved_at": {
"description": "When this service last read MHLW's list page successfully.",
"type": [
"string",
"null"
]
},
"version_observed_at": {
"type": [
"string",
"null"
]
},
"page_sha256": {
"type": [
"string",
"null"
]
},
"processed_by": {
"type": "string"
}
},
"required": [
"list_page_url",
"published_as_of",
"retrieved_at",
"version_observed_at",
"page_sha256",
"processed_by"
],
"additionalProperties": {},
"description": "Where the answer comes from: MHLW's list page, when this service last read it, and the page version used."
},
"legal_notice": {
"type": "string"
},
"attribution": {
"type": "object",
"properties": {
"source_ja": {
"type": "string"
},
"processed_ja": {
"type": "string"
},
"source_en": {
"type": "string"
},
"terms_url": {
"type": "string"
},
"license_url": {
"type": "string"
},
"license_note": {
"type": "string"
}
},
"required": [
"source_ja",
"processed_ja",
"source_en",
"terms_url",
"license_url",
"license_note"
],
"additionalProperties": {}
},
"answered_at": {
"type": "string"
},
"provenance": {
"type": "array",
"items": {
"type": "object",
"properties": {
"source": {
"type": "object",
"properties": {
"publisher": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"publisher",
"url"
],
"additionalProperties": {},
"description": "Publisher and URL of the upstream document or dataset."
},
"upstream_updated_at": {
"description": "Update time stated by the upstream, or null when it states none.",
"type": [
"string",
"null"
]
},
"retrieved_at": {
"description": "When this service retrieved the upstream data (null if unknown).",
"type": [
"string",
"null"
]
},
"content_sha256": {
"type": [
"string",
"null"
]
},
"parser_version": {
"type": "string"
},
"fetch_status": {
"type": "string",
"enum": [
"found",
"empty",
"stale",
"unavailable",
"unsupported"
],
"description": "found / empty / stale / unavailable / unsupported (see catalog fetch_status_values)."
},
"processed_by": {
"type": "string"
}
},
"required": [
"source",
"upstream_updated_at",
"retrieved_at",
"content_sha256",
"parser_version",
"fetch_status",
"processed_by"
],
"additionalProperties": {},
"description": "Freshness receipt for one upstream source."
},
"description": "Freshness receipts for every upstream source used."
},
"terms": {
"type": "string",
"description": "URL of the terms of service."
}
},
"required": [
"official_check",
"query",
"status",
"unknown_reason",
"status_note",
"registry_status",
"today_jst",
"exams",
"candidates",
"total",
"truncated",
"source",
"legal_notice",
"attribution",
"answered_at",
"provenance",
"terms"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {}
}🟢exam_schedule_changes(since, exam, change_type, limit)
Which exam dates on MHLW's list page of national qualification exams changed, appeared or left the list since a date (this service's own record of page versions; MHLW keeps none)? Each change has before and after as published and the time this service first read it. Optional exam and change_type filters. Free window: last 30 days.
Esquema de entrada
{
"type": "object",
"properties": {
"since": {
"type": "string",
"maxLength": 40,
"description": "ISO 8601 date or date-time with time zone, e.g. 2026-10-01 or 2026-10-01T00:00:00Z"
},
"exam": {
"description": "Optional: exam_id or exact exam name",
"type": "string",
"maxLength": 100
},
"change_type": {
"description": "Optional filter: exam_added, exam_reappeared, exam_removed, exam_details_changed, event_added, event_date_changed, event_details_changed, event_removed",
"type": "string",
"enum": [
"exam_added",
"exam_reappeared",
"exam_removed",
"exam_details_changed",
"event_added",
"event_date_changed",
"event_details_changed",
"event_removed"
]
},
"limit": {
"description": "Maximum number of changes, 1-500 (default 100)",
"type": "integer",
"minimum": 1,
"maximum": 500
}
},
"required": [
"since"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Esquema de salida
{
"type": "object",
"properties": {
"official_check": {
"type": "object",
"properties": {
"message": {
"type": "string"
},
"message_ja": {
"type": "string"
},
"urls": {
"type": "array",
"items": {
"type": "string"
}
},
"schedule_change_notices_url": {
"type": "string"
}
},
"required": [
"message",
"message_ja",
"urls",
"schedule_change_notices_url"
],
"additionalProperties": {},
"description": "Read first: dates as published on MHLW's list page at retrieved_at; confirm on the official exam page before applying."
},
"query": {
"type": "object",
"properties": {
"since": {
"type": "string"
}
},
"required": [
"since"
],
"additionalProperties": {}
},
"tracking_since": {
"description": "When this service first read the list page. Changes before it were not observed.",
"type": [
"string",
"null"
]
},
"history_window": {
"type": "object",
"properties": {
"free_days": {
"type": "number",
"description": "Days of recorded history served free of charge."
},
"requested_since": {
"type": "string",
"description": "The since you asked for (normalized to ISO 8601)."
},
"served_since": {
"type": "string",
"description": "The since actually applied: requested_since, or the start of the free window if requested_since was earlier."
},
"clamped": {
"type": "boolean",
"description": "true when requested_since was earlier than the free window and the answer covers only the window."
},
"older_history": {
"type": "string",
"description": "Status of recorded history older than the free window."
}
},
"required": [
"free_days",
"requested_since",
"served_since",
"clamped",
"older_history"
],
"additionalProperties": {},
"description": "Free history window applied to this answer."
},
"coverage": {
"type": "object",
"properties": {
"since_before_tracking": {
"type": "boolean"
},
"note": {
"type": "string"
}
},
"required": [
"since_before_tracking",
"note"
],
"additionalProperties": {}
},
"changes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"change_type": {
"type": "string",
"enum": [
"exam_added",
"exam_reappeared",
"exam_removed",
"exam_details_changed",
"event_added",
"event_date_changed",
"event_details_changed",
"event_removed"
]
},
"date": {
"type": "string"
},
"exam_id": {
"type": "string"
},
"event_id": {
"type": [
"string",
"null"
]
},
"statement": {
"type": "string"
},
"changed_fields": {
"type": "array",
"items": {
"type": "string"
}
},
"before": {},
"after": {}
},
"required": [
"change_type",
"date",
"exam_id",
"event_id",
"statement",
"changed_fields",
"before",
"after"
],
"additionalProperties": {}
},
"description": "Changes observed by this service between versions of the list page, oldest first."
},
"truncated": {
"type": "boolean"
},
"source": {
"type": "object",
"properties": {
"list_page_url": {
"type": "string"
},
"published_as_of": {
"type": [
"string",
"null"
]
},
"retrieved_at": {
"description": "When this service last read MHLW's list page successfully.",
"type": [
"string",
"null"
]
},
"version_observed_at": {
"type": [
"string",
"null"
]
},
"page_sha256": {
"type": [
"string",
"null"
]
},
"processed_by": {
"type": "string"
}
},
"required": [
"list_page_url",
"published_as_of",
"retrieved_at",
"version_observed_at",
"page_sha256",
"processed_by"
],
"additionalProperties": {},
"description": "Where the answer comes from: MHLW's list page, when this service last read it, and the page version used."
},
"legal_notice": {
"type": "string"
},
"history_note": {
"type": "string"
},
"attribution": {
"type": "object",
"properties": {
"source_ja": {
"type": "string"
},
"processed_ja": {
"type": "string"
},
"source_en": {
"type": "string"
},
"terms_url": {
"type": "string"
},
"license_url": {
"type": "string"
},
"license_note": {
"type": "string"
}
},
"required": [
"source_ja",
"processed_ja",
"source_en",
"terms_url",
"license_url",
"license_note"
],
"additionalProperties": {}
},
"answered_at": {
"type": "string"
},
"provenance": {
"type": "array",
"items": {
"type": "object",
"properties": {
"source": {
"type": "object",
"properties": {
"publisher": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"publisher",
"url"
],
"additionalProperties": {},
"description": "Publisher and URL of the upstream document or dataset."
},
"upstream_updated_at": {
"description": "Update time stated by the upstream, or null when it states none.",
"type": [
"string",
"null"
]
},
"retrieved_at": {
"description": "When this service retrieved the upstream data (null if unknown).",
"type": [
"string",
"null"
]
},
"content_sha256": {
"type": [
"string",
"null"
]
},
"parser_version": {
"type": "string"
},
"fetch_status": {
"type": "string",
"enum": [
"found",
"empty",
"stale",
"unavailable",
"unsupported"
],
"description": "found / empty / stale / unavailable / unsupported (see catalog fetch_status_values)."
},
"processed_by": {
"type": "string"
}
},
"required": [
"source",
"upstream_updated_at",
"retrieved_at",
"content_sha256",
"parser_version",
"fetch_status",
"processed_by"
],
"additionalProperties": {},
"description": "Freshness receipt for one upstream source."
},
"description": "Freshness receipts for every upstream source used."
},
"terms": {
"type": "string",
"description": "URL of the terms of service."
}
},
"required": [
"official_check",
"query",
"tracking_since",
"history_window",
"coverage",
"changes",
"truncated",
"source",
"legal_notice",
"history_note",
"attribution",
"answered_at",
"provenance",
"terms"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {}
}🟢get_receipt(receipt_id)
Re-fetch the stored result of a settled paid call by its receipt_id, for when the response was lost after payment. Free. Unknown or unsettled receipt ids return RECEIPT_NOT_FOUND. Results are kept for 90 days after settlement.
Esquema de entrada
{
"type": "object",
"properties": {
"receipt_id": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "The receipt_id returned with a paid result (\"rcpt_\" + 64 hex characters)."
}
},
"required": [
"receipt_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Esquema de salida
{
"type": "object",
"properties": {
"receipt_id": {
"type": "string",
"description": "Receipt id of the settled paid call (\"rcpt_\" + 64 hex). Use with get_receipt."
},
"tool": {
"type": "string",
"description": "Name of the paid tool that produced the result."
},
"settled_at": {
"type": [
"string",
"null"
]
},
"payment": {
"type": "object",
"properties": {
"network": {
"type": [
"string",
"null"
]
},
"transaction": {
"type": [
"string",
"null"
]
}
},
"required": [
"network",
"transaction"
],
"additionalProperties": {}
},
"result": {
"description": "The stored result, exactly as returned by the paid call."
},
"provenance": {
"type": "array",
"items": {
"type": "object",
"properties": {
"source": {
"type": "object",
"properties": {
"publisher": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"publisher",
"url"
],
"additionalProperties": {},
"description": "Publisher and URL of the upstream document or dataset."
},
"upstream_updated_at": {
"description": "Update time stated by the upstream, or null when it states none.",
"type": [
"string",
"null"
]
},
"retrieved_at": {
"description": "When this service retrieved the upstream data (null if unknown).",
"type": [
"string",
"null"
]
},
"content_sha256": {
"type": [
"string",
"null"
]
},
"parser_version": {
"type": "string"
},
"fetch_status": {
"type": "string",
"enum": [
"found",
"empty",
"stale",
"unavailable",
"unsupported"
],
"description": "found / empty / stale / unavailable / unsupported (see catalog fetch_status_values)."
},
"processed_by": {
"type": "string"
}
},
"required": [
"source",
"upstream_updated_at",
"retrieved_at",
"content_sha256",
"parser_version",
"fetch_status",
"processed_by"
],
"additionalProperties": {},
"description": "Freshness receipt for one upstream source."
},
"description": "Freshness receipts for every upstream source used."
},
"terms": {
"type": "string",
"description": "URL of the terms of service."
}
},
"required": [
"receipt_id",
"tool",
"settled_at",
"payment",
"result",
"provenance",
"terms"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": {}
}Comunidad
Evidencia
Observaciones recientes
verificadoversión no registrada4 herramientas